My Support

Create and manage support tickets for billing questions, bug reports, feature requests, and general inquiries. Full threaded replies are supported. Available on Builder tier and above.

Explorer+

stringheaderrequired
Your API key. Authorization: Bearer <key> is accepted in its place.

integerdefault1
Page number, from 1 to 10,000
Range
1 – 10000
Example
integerdefault20
Items per page (max 100)
Range
1 – 100
Example
string
Filter by ticket status
Accepts
stringdefaultcreated_at
Sort field
Accepts
Example
stringdefaultdesc
Sort order
Accepts
Example

application/json

SupportTicket[]
One page of results
string
Opaque ticket id.
string
One-line summary of the issue.
string
Prose summary of the record, where one has been written.
TicketStatus
Lifecycle of a support ticket. waiting means we are waiting on the customer.
TicketPriority
Support ticket priority.
string | null
What the ticket is about: billing, technical, data_quality, feature_request, other.
integer
How many replies the thread holds.
string
When the ticket was opened, ISO 8601.
string
When the ticket last changed, ISO 8601.
string | null
When it was closed, or null while it is open.
number
Current page number
number
Items per page
number
Total matching records (Builder and above)

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Requires Builder tier or higher.

Tickets are sorted by created_at descending.

Full rate limits

Minimum tier: Explorer+
Monthly quota: 200/mo
Rate limit: 10/min
Daily cap: 50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.

1curl --request GET \2  --url 'https://api.gunspec.io/v1/me/support?status=open' \3  --header 'X-API-Key: your_key'

1{2  "success": true,3  "data": [4    {5      "id": "d3f1c2a0-...",6      "subject": "Cannot generate an API key",7      "description": "string",8      "status": "open",9      "priority": "low",10      "category": "technical",11      "reply_count": 2,12      "created_at": "2026-08-23T02:00:00.000Z",13      "updated_at": "string",14      "closed_at": null15    }16  ],17  "pagination": {18    "page": 1,19    "limit": 20,20    "per_page": 20,21    "total": 42,22    "totalPages": 323  }24}

Explorer+

stringheaderrequired
Your API key. Authorization: Bearer <key> is accepted in its place.

application/json

stringrequired
One-line summary of the issue.
stringrequired
Prose summary of the record, where one has been written.
string
What the ticket is about. Not a firearm or attachment category.
string
Triage priority you are asking for. Staff may change it.

application/json

SupportTicket
The response payload
string
Opaque ticket id.
string
One-line summary of the issue.
string
Prose summary of the record, where one has been written.
TicketStatus
Lifecycle of a support ticket. waiting means we are waiting on the customer.
TicketPriority
Support ticket priority.
string | null
What the ticket is about: billing, technical, data_quality, feature_request, other.
integer
How many replies the thread holds.
string
When the ticket was opened, ISO 8601.
string
When the ticket last changed, ISO 8601.
string | null
When it was closed, or null while it is open.

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
413PAYLOAD_TOO_LARGERequest body too large
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Requires Builder tier or higher.

Valid priorities: low, normal, high, urgent. Valid categories: billing, technical, data_quality, feature_request, other.

High-priority tickets are reviewed within 1 business day.

Full rate limits

Minimum tier: Explorer+
Monthly quota: 200/mo
Rate limit: 10/min
Daily cap: 50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.

1curl --request POST \2  --url 'https://api.gunspec.io/v1/me/support' \3  --header 'X-API-Key: your_key' \4  --header 'Content-Type: application/json' \5  --data '6{7  "subject": "API returns 500 on large per_page",8  "description": "Reproduces with per_page=100 on GET /v1/firearms.",9  "priority": "high",10  "category": "technical"11}12'

1{2  "success": true,3  "data": {4    "id": "d3f1c2a0-...",5    "subject": "Cannot generate an API key",6    "description": "string",7    "status": "open",8    "priority": "low",9    "category": "technical",10    "reply_count": 2,11    "created_at": "2026-08-23T02:00:00.000Z",12    "updated_at": "string",13    "closed_at": null14  }15}

Explorer+

stringheaderrequired
Your API key. Authorization: Bearer <key> is accepted in its place.

stringrequired
Support ticket id
Example

application/json

SupportTicket
The response payload
string
Opaque ticket id.
string
One-line summary of the issue.
string
Prose summary of the record, where one has been written.
TicketStatus
Lifecycle of a support ticket. waiting means we are waiting on the customer.
TicketPriority
Support ticket priority.
string | null
What the ticket is about: billing, technical, data_quality, feature_request, other.
integer
How many replies the thread holds.
string
When the ticket was opened, ISO 8601.
string
When the ticket last changed, ISO 8601.
string | null
When it was closed, or null while it is open.
object[]
Every reply on the ticket in the order it was written, staff-internal notes excluded.
integer
Numeric id of the reply.
string
Id of the ticket.
string
Who wrote it: the customer or a staff member.
string
The reply body.
string
When the reply was recorded, ISO 8601 UTC.
object[]
Files attached to the ticket or to one of its replies.
integer
Numeric id of the attachment.
string
Id of the ticket the file belongs to.
integer | null
The reply the file was attached to, or null when it was attached to the ticket itself.
string
Who uploaded it.
string
The name the file was uploaded with.
string
Storage key; download through the ticket attachment endpoint, never by constructing a URL from this.
integer
Bytes.
string
Media type as detected at upload.
string
When the file was attached, ISO 8601 UTC.

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
404NOT_FOUNDResource not found
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Requires Builder tier or higher.

You can only retrieve tickets created by your own API key.

Replies are sorted by created_at ascending (oldest first).

Full rate limits

Minimum tier: Explorer+
Monthly quota: 200/mo
Rate limit: 10/min
Daily cap: 50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.

1curl --request GET \2  --url 'https://api.gunspec.io/v1/me/support/a1b2c3d4-e5f6-7890-abcd-ef1234567890' \3  --header 'X-API-Key: your_key'

1{2  "success": true,3  "data": {4    "id": "d3f1c2a0-...",5    "subject": "Cannot generate an API key",6    "description": "string",7    "status": "open",8    "priority": "low",9    "category": "technical",10    "reply_count": 2,11    "created_at": "2026-08-23T02:00:00.000Z",12    "updated_at": "string",13    "closed_at": null,14    "replies": [15      {16        "id": 12,17        "ticket_id": "d3f1c2a0-...",18        "user_id": "u_...",19        "message": "Still happening on the latest build.",20        "created_at": "2026-08-23T02:00:00.000Z"21      }22    ],23    "attachments": [24      {25        "id": 3,26        "ticket_id": "d3f1c2a0-...",27        "reply_id": null,28        "user_id": "u_...",29        "file_name": "screenshot.png",30        "file_key": "tickets/d3f1c2a0/3.png",31        "file_size": 48213,32        "mime_type": "image/png",33        "created_at": "2026-08-23T02:00:00.000Z"34      }35    ]36  }37}

Explorer+

stringheaderrequired
Your API key. Authorization: Bearer <key> is accepted in its place.

stringrequired
Support ticket id
Example

application/json

stringrequired
The reply body. Plain text.

application/json

object
The response payload.
integer
Numeric id of the reply.
string
Id of the ticket the reply was added to.
string
The reply body, as sent.
string
When the reply was recorded, ISO 8601 UTC.

400VALIDATION_ERRORValidation error
401UNAUTHORIZEDAPI key required
403FORBIDDENValid key, not permitted
404NOT_FOUNDResource not found
413PAYLOAD_TOO_LARGERequest body too large
429RATE_LIMITEDRate limit exceeded
500INTERNAL_ERRORUnexpected server error

Requires Builder tier or higher.

Replies cannot be added to tickets with status closed.

You can only reply to tickets created by your own API key.

Full rate limits

Minimum tier: Explorer+
Monthly quota: 200/mo
Rate limit: 10/min
Daily cap: 50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.

1curl --request POST \2  --url 'https://api.gunspec.io/v1/me/support/a1b2c3d4-e5f6-7890-abcd-ef1234567890/replies' \3  --header 'X-API-Key: your_key' \4  --header 'Content-Type: application/json' \5  --data '6{7  "message": "Thanks for the update! Working perfectly now."8}9'

1{2  "success": true,3  "data": {4    "id": 12,5    "ticket_id": "d3f1c2a0-...",6    "message": "Still happening on the latest build.",7    "created_at": "2026-08-23T02:00:00.000Z"8  }9}

My Support

List Tickets

Explorer+

application/json

Full rate limits

Create Ticket

Explorer+

application/json

application/json

Full rate limits

Get Ticket

Explorer+

application/json

Full rate limits

Reply to Ticket

Explorer+

application/json

application/json

Full rate limits

My Support

AuthorizationExplorer+

Query Parameters

Response200application/json

Errors

Notes

Rate limitsFull rate limits

AuthorizationExplorer+

Request Bodyapplication/json

Response201application/json

Errors

Notes

Rate limitsFull rate limits

AuthorizationExplorer+

Path Parameters

Response200application/json

Errors

Notes

Rate limitsFull rate limits

AuthorizationExplorer+

Path Parameters

Request Bodyapplication/json

Response201application/json

Errors

Notes

Rate limitsFull rate limits

Explorer+

application/json

Full rate limits

Explorer+

application/json

application/json

Full rate limits

Explorer+

application/json

Full rate limits

Explorer+

application/json

application/json

Full rate limits