Operation
Get customer
GET
/customers/{customerId}Get a specific customer by ID. Account-scoped: readable when the record belongs to an account the caller may read, or provenance has shared it with one. Never channel-scoped.
Path parameters
customerIdstringRequired- Customer ID
Returns
Customer 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" \ -H "Authorization: Bearer tlak_..." \ -H "X-Ticketlayer-Org: your-org-slug"Response 200
{
"customer": {
"id": "cus_abc123",
"organisationId": "org_xyz789",
"accountId": "acc_xyz789",
"email": "customer@example.com",
"firstName": "John",
"lastName": "Doe",
"phone": "+44 7700 900000",
"externalId": "ext_cust_12345",
"isBlocked": false,
"blockedAt": null,
"blockedReason": null,
"metadata": {
"loyaltyTier": "gold"
},
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-20T14:45:00Z"
}
}