Get customer

Get one customer by its ID.

GET /customers/{customerId}

Authentication

Send your API key as a bearer token. See Authentication .

Path parameters

Parameter	Type	Notes
`customerId`	UUID	The ID of the customer.

Query parameters

Parameter	Type	Notes
`projectId`	UUID	Required. The project the customer belongs to.

Response

{
  "customerId": "c1a2b3c4-d5e6-4f70-8a9b-0c1d2e3f4a5b",
  "projectId": "8a7b6c5d-4e3f-2a1b-0c9d-8e7f6a5b4c3d",
  "name": "Dana Lang",
  "email": "dana@acme.com",
  "company": "Acme",
  "jobTitle": "Head of Growth",
  "industry": "SaaS",
  "avatarUrl": null,
  "socialHandle": null,
  "companyLogoUrl": null,
  "source": "manual",
  "status": "subscribed",
  "unsubscribedAt": null,
  "createdAt": "2026-08-25T08:30:00.000Z",
  "updatedAt": "2026-08-25T08:30:00.000Z"
}

See List customers for the meaning of each field.

Errors

Returns 404 if no customer with that ID exists in the project.

Example

curl "https://app.contendar.com/api/v1/customers/c1a2b3c4-d5e6-4f70-8a9b-0c1d2e3f4a5b?projectId=YOUR_PROJECT_ID" \
  -H "Authorization: Bearer ck_your_key_here"

Was this helpful?