GET
/
customers
curl --request GET \
  --url https://base_url/api/v1/customers \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "customers": [
      {
        "id": "b6d009b0-d174-463f-b030-94643c28e209",
        "corporation_id": "2535af08-a139-4d0c-9827-1651e46dfbcf",
        "name": "John Doe",
        "created_at": 1727284490
      }
    ],
    "cursor": "<string>",
    "total_customers": 123
  },
  "message": "Successfully fetched customers."
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

corporation_id
string
required

The unique identifier for a corporation used to filter the relevant customer base.

cursor
string

Cursor for pagination

limit
integer
default:
10

Number of items to return per page

Required range: 1 <= x <= 100

Response

200
application/json
List of customers associated with the requesting corporation
data
object
message
string
Example:

"Successfully fetched customers."