Fake tickets API

Connect

curl "https://api.sondahub.com/v1/helpdesk/tickets?limit=3"

Sample records

Records 1 to 3 of 2,000, exactly as GET /v1/helpdesk/tickets/{id} answers them. The data file holds all of them.

[
  {
    "id": 1,
    "created_at": "2026-07-24T22:23:40Z",
    "updated_at": "2026-07-31T02:08:40Z",
    "number": "HD-10001",
    "subject": "Cannot log in after password reset",
    "description": "I have already tried clearing the cache and signing in again. Here are the steps to reproduce it.",
    "status": "closed",
    "priority": "normal",
    "category": "account",
    "channel": "email",
    "customer_id": 208,
    "requester_email": "[email protected]",
    "assignee_id": 6,
    "team_id": 1,
    "tags": [],
    "first_response_at": "2026-07-25T18:32:40Z",
    "resolved_at": "2026-07-29T17:56:40Z",
    "closed_at": "2026-07-31T02:08:40Z",
    "due_at": "2026-07-25T22:23:40Z",
    "sla_breached": false,
    "satisfaction": null,
    "message_count": 3
  },
  {
    "id": 2,
    "created_at": "2026-05-09T02:21:47Z",
    "updated_at": "2026-05-15T05:38:47Z",
    "number": "HD-10002",
    "subject": "Change the email on my account",
    "description": "It happens on both my laptop and my phone.",
    "status": "closed",
    "priority": "high",
    "category": "account",
    "channel": "web",
    "customer_id": 58,
    "requester_email": "[email protected]",
    "assignee_id": 11,
    "team_id": 2,
    "tags": [
      "api"
    ],
    "first_response_at": "2026-05-10T15:35:47Z",
    "resolved_at": "2026-05-14T23:59:47Z",
    "closed_at": "2026-05-15T05:38:47Z",
    "due_at": "2026-05-12T02:21:47Z",
    "sla_breached": false,
    "satisfaction": 5,
    "message_count": 1
  },
  {
    "id": 3,
    "created_at": "2026-06-01T00:30:09Z",
    "updated_at": "2026-06-09T13:06:09Z",
    "number": "HD-10003",
    "subject": "Keyboard shortcut for new item",
    "description": "Here are the steps to reproduce it. I have already tried clearing the cache and signing in again.",
    "status": "closed",
    "priority": "normal",
    "category": "feature",
    "channel": "email",
    "customer_id": 226,
    "requester_email": "[email protected]",
    "assignee_id": 6,
    "team_id": 1,
    "tags": [],
    "first_response_at": "2026-06-01T18:53:09Z",
    "resolved_at": "2026-06-06T18:29:09Z",
    "closed_at": "2026-06-09T13:06:09Z",
    "due_at": "2026-06-04T00:30:09Z",
    "sla_breached": false,
    "satisfaction": null,
    "message_count": 4
  }
]

Fields

Relations: customer → one customer through customer_id; assignee → one agent through assignee_id; team → one team through team_id; messages → the messages whose ticket_id is this ticket. Use ?expand=customer,assignee,team,messages to embed them, or the nested routes.

Endpoints

Try it

curl "https://api.sondahub.com/v1/helpdesk/tickets?status=pending&satisfaction_gte=1&expand=customer&limit=3"

curl https://api.sondahub.com/v1/helpdesk/tickets/1?expand=customer

curl "https://api.sondahub.com/v1/helpdesk/tickets/1/messages?limit=5"

curl -i -X POST https://api.sondahub.com/v1/helpdesk/tickets \
  -H "Content-Type: application/json" \
  -d '{"subject":"A subject","status":"open","priority":"low","category":"billing","channel":"email","customer_id":1}'

curl "https://api.sondahub.com/v1/helpdesk/tickets?sort=-id&limit=3" \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

curl -X PATCH https://api.sondahub.com/v1/helpdesk/tickets/4 \
  -H "Content-Type: application/json" \
  -d '{"status":"pending"}'

curl -X DELETE https://api.sondahub.com/v1/helpdesk/tickets/2001 \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Query recipes

Every list option works on tickets; these are ready to paste. All the options.

GraphQL

The same tickets as the tickets query on https://api.sondahub.com/v1/helpdesk/graphql, and one ticket as ticket(id: 1). Introspection is on. More on the GraphQL API.

{
  tickets(limit: 3, sort: "-id", filter: { status: open }) {
    total
    data {
      id number subject description
      customer { name }
      messages(limit: 2) { id }
    }
  }
}

curl https://api.sondahub.com/v1/helpdesk/graphql -H "Content-Type: application/json" -d '{"query": "{ tickets(limit: 3, sort: \"-id\", filter: { status: open }) { total data { id number subject description customer { name } messages(limit: 2) { id } } } }"}'

From an AI agent (MCP)

The MCP server reaches the same rows with list_records, get_record, create_record, update_record and delete_record, and as the resource sondahub://helpdesk/tickets.

curl https://api.sondahub.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_records","arguments":{"api":"helpdesk","collection":"tickets","filters":{"status":"open"},"limit":3}}}'

More in the Helpdesk API

teams (4) · agents (25) · customers (300) · messages (5,069)

The live streams, and the whole API on one page: Helpdesk API. Other worlds: fake e-commerce API, fake IoT API, fake banking API, fake social media API, fake flight booking API, fake user directory API.