Operation

Get customer history

GET/customers/{customerId}/history

Every change to a customer record: who made it, when, from which request, and each field from and to. Readable by whoever reads the customer. Newest first. Each change shows only the fields the caller may read: a change to a field above their tier is not shown, and a change made only to such fields is left out. Paged by cursor.

Path parameters

customerIdstringRequired: Customer ID

Query parameters

cursorstringOptional: nextCursor from the previous page
limitintegerOptional: Rows to read (default 50, max 200)

Returns

Customer history retrieved successfully

Errors

400: Bad Request - Invalid input
401: Unauthorized - Authentication required
403: Forbidden - Insufficient permissions
404: Not Found - Resource not found
500: Internal Server Error

Every error names its code and links to it. All error codes

curl -X GET "https://api.ticketlayer.com/v1/customers/cus_abc123/history" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug"

Response 200

{
  "history": [
    {
      "id": "1042",
      "objectType": "order",
      "objectId": "ord_abc123xyz789",
      "kind": "updated",
      "version": null,
      "actor": {
        "kind": "user",
        "id": "usr_abc123"
      },
      "requestId": "req_abc123",
      "at": "2026-10-02T10:30:00.123Z",
      "changes": {
        "status": {
          "from": "pending",
          "to": "confirmed"
        }
      },
      "redacted": false
    }
  ],
  "nextCursor": null
}

Get customer history

Path parameters

Query parameters

Returns

Errors

Try it in test mode

Path parameters

Query parameters