Clients API

📡

Clients API

List clients

Returns all clients in the Space, ordered by creation date descending.

Example request

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/clients" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/clients" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/clients" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

Response

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acme.com",
      "company": "Acme Studios",
      "phone": "+1 (647) 555 0100",
      "website": "https://acme.com",
      "notes": "Met at conference.",
      "job_title": "CEO",
      "location": "New York, USA",
      "product": null,
      "service": null,
      "tags": ["enterprise", "priority"],
      "status": "active",
      "profile_image_url": "https://...",
      "last_activity_at": "2026-05-10T14:00:00.000Z",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-05-10T14:00:00.000Z",
      "custom_field_values": null
    }
  ]
}

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acme.com",
      "company": "Acme Studios",
      "phone": "+1 (647) 555 0100",
      "website": "https://acme.com",
      "notes": "Met at conference.",
      "job_title": "CEO",
      "location": "New York, USA",
      "product": null,
      "service": null,
      "tags": ["enterprise", "priority"],
      "status": "active",
      "profile_image_url": "https://...",
      "last_activity_at": "2026-05-10T14:00:00.000Z",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-05-10T14:00:00.000Z",
      "custom_field_values": null
    }
  ]
}

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "first_name": "Jane",
      "last_name": "Smith",
      "email": "jane@acme.com",
      "company": "Acme Studios",
      "phone": "+1 (647) 555 0100",
      "website": "https://acme.com",
      "notes": "Met at conference.",
      "job_title": "CEO",
      "location": "New York, USA",
      "product": null,
      "service": null,
      "tags": ["enterprise", "priority"],
      "status": "active",
      "profile_image_url": "https://...",
      "last_activity_at": "2026-05-10T14:00:00.000Z",
      "created_at": "2026-04-01T09:00:00.000Z",
      "updated_at": "2026-05-10T14:00:00.000Z",
      "custom_field_values": null
    }
  ]
}

Client fields

Field	Type	Notes
`id`	UUID
`first_name`	string
`last_name`	string or null
`email`	string or null
`company`	string or null
`phone`	string or null
`website`	string or null
`notes`	string or null
`job_title`	string or null
`location`	string or null
`product`	string or null
`service`	string or null
`tags`	string array	Empty array if no tags
`status`	string	`"active"`, `"paused"`, or `"inactive"`
`profile_image_url`	string or null
`last_activity_at`	ISO 8601 string or null
`created_at`	ISO 8601 string
`updated_at`	ISO 8601 string
`custom_field_values`	object or null	Workspace custom field values

List testimonials for a client

Returns testimonials linked to the specified client. Returns a maximum of 50 results, ordered by source_created_at descending.

Example request

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/clients/CLIENT_ID/testimonials" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/clients/CLIENT_ID/testimonials" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

curl "https://app.endors.io/api/spaces/YOUR_SPACE_ID/clients/CLIENT_ID/testimonials" \
  -H "Authorization: Bearer sk_live_your_api_key_here"

Response

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "type": "video",
      "name": "Jane Smith",
      "text_content": null,
      "rating": 5,
      "source_created_at": "2026-05-01T10:00:00.000Z",
      "created_at": "2026-05-01T10:05:00.000Z",
      "updated_at": "2026-05-01T10:05:00.000Z",
      "active_asset": {
        "id": "uuid",
        "type": "video",
        "status": "ready",
        "originalFilename": "testimonial.mp4",
        "durationSeconds": 38.2,
        "embedUrl": "https://customer.cloudflarestream.com/.../iframe",
        "hlsUrl": "https://customer.cloudflarestream.com/.../manifest/video.m3u8",
        "posterUrl": "https://customer.cloudflarestream.com/.../thumbnails/thumbnail.jpg",
        "trimStartSeconds": null,
        "trimEndSeconds": null
      }
    }
  ]
}

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "type": "video",
      "name": "Jane Smith",
      "text_content": null,
      "rating": 5,
      "source_created_at": "2026-05-01T10:00:00.000Z",
      "created_at": "2026-05-01T10:05:00.000Z",
      "updated_at": "2026-05-01T10:05:00.000Z",
      "active_asset": {
        "id": "uuid",
        "type": "video",
        "status": "ready",
        "originalFilename": "testimonial.mp4",
        "durationSeconds": 38.2,
        "embedUrl": "https://customer.cloudflarestream.com/.../iframe",
        "hlsUrl": "https://customer.cloudflarestream.com/.../manifest/video.m3u8",
        "posterUrl": "https://customer.cloudflarestream.com/.../thumbnails/thumbnail.jpg",
        "trimStartSeconds": null,
        "trimEndSeconds": null
      }
    }
  ]
}

{
  "ok": true,
  "data": [
    {
      "id": "uuid",
      "type": "video",
      "name": "Jane Smith",
      "text_content": null,
      "rating": 5,
      "source_created_at": "2026-05-01T10:00:00.000Z",
      "created_at": "2026-05-01T10:05:00.000Z",
      "updated_at": "2026-05-01T10:05:00.000Z",
      "active_asset": {
        "id": "uuid",
        "type": "video",
        "status": "ready",
        "originalFilename": "testimonial.mp4",
        "durationSeconds": 38.2,
        "embedUrl": "https://customer.cloudflarestream.com/.../iframe",
        "hlsUrl": "https://customer.cloudflarestream.com/.../manifest/video.m3u8",
        "posterUrl": "https://customer.cloudflarestream.com/.../thumbnails/thumbnail.jpg",
        "trimStartSeconds": null,
        "trimEndSeconds": null
      }
    }
  ]
}

The active_asset shape is the same as described in the Testimonials API.

Errors

HTTP	Code	Message
500	`DB_ERROR`	Internal database error