Skip to main content
GET
/
organizations
/
{organizationId}
/
customers
List all customers for an organization
curl --request GET \
  --url http://sandbox.mintlify.com/organizations/{organizationId}/customers \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "org-uuid",
    "legalName": "Dunder Mifflin",
    "taxId": "ABC101010111",
    "taxSystem": "601",
    "email": "email@example.com",
    "defaultInvoiceUse": "G01",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": "142",
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": "86500",
      "state": "Sonora",
      "country": "MEX",
      "interior": "4"
    },
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "phone": "6474010101"
  }
]
Returns all customers belonging to an organization.

​
Authentication

Requires a valid Bearer token. The authenticated user must be a member of the organization.

​
Path Parameters

ParameterTypeRequiredDescription
organizationIdstring (UUID)YesOrganization ID

​
Example Request

curl -X GET http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/customers \
  -H "Authorization: Bearer <your_token>"

​
Example Response

[
  {
    "id": "590ce6c56d04f840aa8438af",
    "organizationId": "550e8400-e29b-41d4-a716-446655440000",
    "legalName": "Dunder Mifflin",
    "taxId": "DUM901231AB3",
    "taxSystem": "601",
    "email": "billing@dundermifflin.com",
    "phone": "6474010101",
    "defaultInvoiceUse": "G01",
    "address": {
      "street": "Blvd. Atardecer",
      "exterior": "142",
      "interior": null,
      "neighborhood": "Centro",
      "city": "Huatabampo",
      "municipality": "Huatabampo",
      "zip": "86500",
      "state": "Sonora",
      "country": "MEX"
    },
    "createdAt": "2025-01-26T10:00:00Z",
    "updatedAt": "2025-01-26T10:00:00Z"
  }
]

​
Common Errors

​
401 Unauthorized

Authentication required.

​
403 Forbidden

User is not a member of this organization.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
organizationId
string
required

Response

200 - application/json
​
id
string
required
Example:

"590ce6c56d04f840aa8438af"

​
organizationId
string
required
Example:

"org-uuid"

​
legalName
string
required
Example:

"Dunder Mifflin"

​
taxId
string
required
Example:

"ABC101010111"

​
taxSystem
string
required
Example:

"601"

​
email
string
required
Example:

"email@example.com"

​
defaultInvoiceUse
string
required
Example:

"G01"

​
address
object
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
phone
object
Example:

"6474010101"