Customers

Get a customer

Changed on Nov 3, 2026

Returns a single customer by doola customer ID, including the companies that customer owns.

get/v1/partner/customers/{customerId}

Request

Base URL
https://api.test.doola.com
URL
https://api.test.doola.com/v1/partner/customers/{customerId}
Auth
API key in header Authorization

Path parameters

customerIdstring required

doola customer ID (KSUID).

Response

doolaCustomerIdstring

doola customer ID (KSUID).

externalCustomerIdstring nullable

Your own user id, as sent as externalCustomerId when minting an SDK customer session. Null when never sent.

emailstring

Customer email address.

firstNamestring

lastNamestring

countryOfResidencestring

ISO 3166-1 alpha-3 country of residence (e.g. USA).

phoneNumberstring

source'MCP' | 'PARTNER_API' | 'PARTNER_SDK' | 'WHOP_APP' | 'DOOLA_DASHBOARDS'

How the customer was created.

createdboolean

True if this request created the customer; false if it already existed.

Example response

{
  "externalCustomerId": "usr_8f21c",
  "email": "founder@example.com",
  "firstName": "Ada",
  "lastName": "Lovelace",
  "countryOfResidence": "USA",
  "phoneNumber": "+12125550100",
  "companies": [
    {
      "name": "Acme Labs LLC",
      "entityType": "LLC",
      "state": "DE"
    }
  ]
}

Changes

Nov 3, 2026f607744a8927 Revision changes
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history