Skip to main content
GET
/
partner
/
customers
List customers
curl --request GET \
  --url https://api.prod.commenda.io/api/v1/partner/customers \
  --header 'x-api-key: <api-key>'
{
  "customers": [
    {
      "id": 77,
      "name": "Acme Holdings",
      "createdAt": "2026-04-20T19:35:00.000Z",
      "updatedAt": "2026-04-20T19:40:00.000Z"
    }
  ],
  "count": 1
}
List customers visible to the authenticated partner API key. Use this endpoint when you need to recover a customer id before creating incorporations or managing customer-scoped Commenda OS resources. 
curl --request GET \
  --url 'https://api.prod.commenda.io/api/v1/partner/customers' \
  --header 'x-api-key: YOUR_API_KEY'

{
  "customers": [
    {
      "id": 77,
      "name": "Acme Holdings",
      "createdAt": "2026-04-20T19:35:00.000Z",
      "updatedAt": "2026-04-20T19:40:00.000Z"
    }
  ],
  "count": 1
}

Authorizations

​
x-api-key
string
header
required

Response

Customers retrieved successfully

​
customers
object[]
required
​
count
integer
required
Example:

1