Skip to content
Docs
Operation

List customer notes

GET/customers/{customerId}/notes
The staff notes on a customer, newest first, at the tiers the caller reads: internal notes to whoever reads the customer, restricted ones only with the restricted permission. Paged by cursor.

Path parameters

customerIdstringRequired
Customer ID

Query parameters

cursorstringOptional
nextCursor from the previous page
limitintegerOptional
Notes per page (default 50, max 200)

Returns

Notes 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/notes" \  -H "Authorization: Bearer tlak_..." \  -H "X-Ticketlayer-Org: your-org-slug"
Response 200
{
  "notes": [
    {
      "id": "nte_abc123def456ghi789jk",
      "objectType": "order",
      "objectId": "ord_abc123xyz789",
      "tier": "internal",
      "body": "Customer called: wants the seats moved to the aisle.",
      "author": {
        "kind": "user",
        "id": "usr_abc123"
      },
      "legacyField": null,
      "createdAt": "2026-10-02T10:30:00.000Z",
      "editedAt": null,
      "deletedAt": null,
      "redactedAt": null
    }
  ],
  "nextCursor": null
}

Try it in test mode

Path parameters
Customer ID
Query parameters
nextCursor from the previous page
Notes per page (default 50, max 200)