Skip to Content
CallMitraDocs
API referenceTickets

List tickets

Newest change first by default. Filter by status, type, priority, lead, category, team or tag.

GET
/api/v1/tickets/

Newest change first by default. Filter by status, type, priority, lead, category, team or tag.

Authorization

headerX-API-Key<token>

Create in the console: Settings → API & webhooks.

Query Parameters

page?Page

Page number, from 1.

Range1 <= value <= 100000
Default1
limit?Limit

Tickets per page (1-200).

Range1 <= value <= 200
Default25
search?|

Ticket ref, words in the subject or description, or the lead's name or phone.

status?|

open, in_progress, waiting_on_customer, resolved or closed; open also matches in_progress and waiting_on_customer.

type?|

support or sales_followup.

leadId?|

Only this lead's tickets.

sourceCallId?|

Only tickets opened from this call.

unassigned?Unassigned

Only tickets nobody is assigned to.

Defaultfalse
priority?|

low, normal, high or urgent.

tag?|

Only tickets with this tag.

categoryId?|

Category id, or none for tickets without one.

teamId?|

Team id, or none for tickets without one.

sort?|

updated (default), created, due, priority or status.

dir?|

asc or desc.

Response Body

OK

application/json
  1. response
pagination*
sort*
success*Success

Always true on a 2xx response.

tickets*array<>
[key: string]?any
Example Request
curl -X GET 'https://api.callmitra.ai/api/v1/tickets/'
Example Response
{  "pagination": {    "currentPage": 1,    "hasNextPage": false,    "hasPreviousPage": false,    "itemsPerPage": 25,    "totalCapped": false,    "totalItems": 1,    "totalPages": 1  },  "sort": {    "dir": "desc",    "key": "updated"  },  "success": true,  "tickets": [    {      "activityCount": 1,      "assignedToUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",      "assigneeEmail": "[email protected]",      "assigneeName": "Priya Nair",      "assigneeNames": [        "Priya Nair"      ],      "assignees": [        {          "assignedAt": "2026-01-15T09:30:02+00:00",          "email": "[email protected]",          "name": "Priya Nair",          "userId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f"        }      ],      "categoryId": "3b9f1d7e-6c2a-4e85-a0d4-7f1e2c3b4a56",      "categoryName": "Delivery",      "createdAt": "2026-01-15T09:30:00+00:00",      "createdByUserId": "c2d4e6f8-1a3b-4c5d-8e7f-9a0b1c2d3e4f",      "description": "Customer says the parcel was marked delivered but never arrived.",      "dueAt": "2026-01-16T09:30:00+00:00",      "id": "5f0c9a3e-2b7d-4c61-9e84-1d6a7b3c2f90",      "leadId": "a41e7c2d-8f35-4b09-b6d2-93c0e5f1a7b8",      "leadName": "Asha Verma",      "leadPhone": "+919812345678",      "merchantId": "9d8c7b6a-5f4e-4d3c-8b2a-1f0e9d8c7b6a",      "overdue": false,      "priority": "normal",      "ref": "T-5F0C9A3E",      "sla": {        "firstResponse": {          "dueAt": "2026-01-15T13:30:00+00:00",          "state": "ok",          "warnAt": "2026-01-15T12:30:00+00:00"        },        "paused": false,        "resolution": {          "dueAt": "2026-01-16T09:30:00+00:00",          "state": "ok",          "warnAt": "2026-01-16T05:30:00+00:00"        }      },      "source": "manual",      "status": "open",      "subject": "Order #1042 not delivered",      "tags": [        "order-1042"      ],      "teamId": "e7a1c3d5-9b2f-4d68-8a0c-2e4f6a8b0c1d",      "teamName": "Customer care",      "type": "support",      "updatedAt": "2026-01-15T09:30:00+00:00",      "version": 1    }  ]}