Skip to main content
GET
/
organizations
/
{organizationId}
/
customers
/
{customerId}
Get a customer by ID
curl --request GET \
  --url http://sandbox.mintlify.com/organizations/{organizationId}/customers/{customerId} \
  --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 a single customer by ID.

​
Authentication

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

​
Path Parameters

ParameterTypeRequiredDescription
organizationIdstring (UUID)YesOrganization ID
customerIdstringYesCustomer ID

​
Example Request

curl -X GET http://localhost:3001/api/organizations/550e8400-e29b-41d4-a716-446655440000/customers/590ce6c56d04f840aa8438af \
  -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.

​
404 Not Found

Customer not found.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
organizationId
string
required
​
customerId
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"