Skip to main content
GET
/
api
/
v1
/
customers
curl -X GET "https://app.monk.com/api/v1/customers?limit=10" \
  -H "Authorization: Bearer mk_live_your_api_key"

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Corp",
      "legalName": "Acme Corporation Inc.",
      "tags": ["enterprise", "priority"],
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-15T00:00:00.000Z"
    }
  ],
  "hasMore": false,
  "total": 1
}

​
Authentication

​
Authorization
string
required
Bearer token with your API key. Example: Bearer mk_live_...
Required scope: customers:read

​
Query Parameters

​
limit
integer
default:"10"
Maximum number of customers to return. Max: 100
​
offset
integer
default:"0"
Number of customers to skip for pagination

​
Response

​
data
array
Array of customer objects
​
hasMore
boolean
Whether more results exist beyond the current page
​
total
integer
Total count of customers matching the query
curl -X GET "https://app.monk.com/api/v1/customers?limit=10" \
  -H "Authorization: Bearer mk_live_your_api_key"

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Acme Corp",
      "legalName": "Acme Corporation Inc.",
      "tags": ["enterprise", "priority"],
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-15T00:00:00.000Z"
    }
  ],
  "hasMore": false,
  "total": 1
}