Operation
List customer notes
GET
/customers/{customerId}/notesThe 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
}