List Customers

GET

/v1/customers

Returns a paginated list of customers associated with the current workspace account ordered by creation date descending.

Parameters

NameTypeDescription
pageintegerPage number (default: 1)
per_pageintegerNumber of records per page (1-100, default: 20)

Responses

200Paginated list of customers
{
  "data": [
    {
      "id": "cst_101",
      "name": "Alice Johnson",
      "email": "alice@example.com",
      "phone_number": "+15552345678",
      "created_at": "2026-08-10T14:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 95,
    "per_page": 20
  }
}