Skip to main content
The tickets API exposes support ticket data for the web dashboard. Tickets are created and managed via the /ticket slash command in Discord. Base path: /api/v1/guilds/:id/tickets Authentication: API key or JWT Bearer token required. Admin permission required. Rate limit: 30 requests per minute per IP.

​
GET /guilds/:id/tickets

Returns a paginated list of tickets for the guild with optional status and user filters.

​
Path parameters

​
id
string
required
The Discord guild ID.

​
Query parameters

​
status
string
Filter by ticket status. Options: open, closed.
​
user
string
Filter to tickets opened by a specific Discord user ID.
​
page
integer
default:"1"
Page number.
​
limit
integer
default:"25"
Items per page. Maximum 100.

​
Response

​
tickets
array
List of ticket objects.
​
total
integer
Total matching tickets.
​
page
integer
Current page number.
​
limit
integer
Items per page.

​
Example

curl -H "x-api-secret: YOUR_SECRET" \
  "https://volvox.bot/api/v1/guilds/987654321/tickets?status=open&limit=10"

{
  "tickets": [
    {
      "id": 7,
      "guild_id": "987654321",
      "user_id": "111222333",
      "topic": "Can't access the voice channels",
      "status": "open",
      "thread_id": "999888777",
      "channel_id": "555444333",
      "closed_by": null,
      "close_reason": null,
      "created_at": "2026-03-20T09:15:00.000Z",
      "closed_at": null
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10
}

​
GET /guilds/:id/tickets/:ticketId

Returns full details for a single ticket.

​
Path parameters

​
id
string
required
The Discord guild ID.
​
ticketId
integer
required
The database ticket ID.

​
Example

curl -H "x-api-secret: YOUR_SECRET" \
  "https://volvox.bot/api/v1/guilds/987654321/tickets/7"

​
Error responses

StatusCause
400Non-integer ticketId
404Ticket not found for this guild
503Database unavailable

​
GET /guilds/:id/tickets/stats

Returns aggregate ticket statistics for the guild.

​
Path parameters

​
id
string
required
The Discord guild ID.

​
Response

​
openCount
integer
Number of currently open tickets.
​
avgResolutionSeconds
integer
Average time to close a ticket in seconds across all closed tickets. 0 if no tickets have been closed.
​
ticketsThisWeek
integer
Tickets created in the last 7 days.

​
Example

curl -H "x-api-secret: YOUR_SECRET" \
  "https://volvox.bot/api/v1/guilds/987654321/tickets/stats"

{
  "openCount": 3,
  "avgResolutionSeconds": 14400,
  "ticketsThisWeek": 12
}

Build docs developers (and LLMs) love

Get started for freeTalk to us