API Reference
Tickets Endpoint
List, create, retrieve, and update tickets via the Ticket0 REST API.
List tickets
GET /ticketsScopes required: tickets:read
Query parameters:
| Parameter | Type | Description |
|---|---|---|
status | string | Filter by status: open, pending, resolved, snoozed |
assigneeId | string | Filter by assignee ID |
inboxId | string | Filter by inbox ID |
tag | string | Filter by tag name |
limit | number | Results per page (default: 20, max: 100) |
cursor | string | Pagination cursor from previous response |
Response:
{
"tickets": [
{
"id": "tkt_01abc...",
"subject": "My order hasn't arrived",
"status": "open",
"assigneeId": "usr_01abc...",
"customerId": "cus_01abc...",
"inboxId": "inb_01abc...",
"tags": ["shipping"],
"createdAt": "2025-01-15T10:30:00Z",
"updatedAt": "2025-01-15T10:30:00Z"
}
],
"nextCursor": "cur_01abc..."
}Create a ticket
POST /ticketsScopes required: tickets:write
Request body:
{
"subject": "Question about billing",
"customerEmail": "jane@example.com",
"inboxId": "inb_01abc...",
"body": "Hi, I was charged twice this month..."
}Response: The created ticket object.
Get a ticket
GET /tickets/:idScopes required: tickets:read
Returns the full ticket object including all metadata.
Update a ticket
PATCH /tickets/:idScopes required: tickets:write
Request body (all fields optional):
{
"status": "resolved",
"assigneeId": "usr_01abc...",
"tags": ["billing", "resolved-by-api"]
}