Skip to main content
GET
/
external
/
customers
/
{id}
Get customer by ID
curl --request GET \
  --url https://platform.runonatlas.com/external/customers/{id} \
  --header 'x-api-key: <api-key>'
{
  "createdAt": "2021-01-01T00:00:00.000Z",
  "id": "atlas-internal-customer-id-123",
  "updatedAt": "2021-01-01T00:00:00.000Z",
  "merchantId": "atlas-internal-merchant-id-123",
  "billingAddress1": "123 Main St",
  "billingAddress2": "Apt 1",
  "billingCity": "Anytown",
  "billingCountry": "US",
  "billingState": "CA",
  "billingZipCode": "12345",
  "shippingAddress1": "123 Main St",
  "shippingAddress2": "Apt 1",
  "shippingCity": "Anytown",
  "shippingCountry": "US",
  "shippingState": "CA",
  "shippingZipCode": "12345",
  "email": "john.doe@example.com",
  "externalId": "external-customer-id-123",
  "name": "John Doe",
  "quickBooksId": "quickbooks-customer-id-123",
  "stripeId": "stripe-customer-id-123"
}

Documentation Index

Fetch the complete documentation index at: https://docs.runonatlas.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

You can obtain this key from the Atlas dashboard. It must be of type secret

Path Parameters

​
id
string
required

The Atlas customer ID

Minimum string length: 1
Example:

"atlas-internal-customer-id-123"

Response

The customer that has been retrieved.

​
createdAt
string<date>
required

The date and time the customer was created

Example:

"2021-01-01T00:00:00.000Z"

​
id
string
required

The Atlas customer ID

Minimum string length: 1
Example:

"atlas-internal-customer-id-123"

​
updatedAt
string<date>
required

The date and time the customer was last updated

Example:

"2021-01-01T00:00:00.000Z"

​
merchantId
string
required

The Atlas merchant ID

Minimum string length: 1
Example:

"atlas-internal-merchant-id-123"

​
billingAddress1
string | null

Billing address line 1

Minimum string length: 1
Example:

"123 Main St"

​
billingAddress2
string | null

Billing address line 2

Minimum string length: 1
Example:

"Apt 1"

​
billingCity
string | null

Billing city

Minimum string length: 1
Example:

"Anytown"

​
billingCountry
string | null

Billing country

Minimum string length: 1
Example:

"US"

​
billingState
string | null

Billing state

Minimum string length: 1
Example:

"CA"

​
billingZipCode
string | null

Billing zip code. Must be 5 digits or 5+4 format.

Pattern: ^\d{5}(-\d{4})?$
Example:

"12345"

​
shippingAddress1
string | null

Shipping address line 1

Minimum string length: 1
Example:

"123 Main St"

​
shippingAddress2
string | null

Shipping address line 2

Minimum string length: 1
Example:

"Apt 1"

​
shippingCity
string | null

Shipping city

Minimum string length: 1
Example:

"Anytown"

​
shippingCountry
string | null

Shipping country

Minimum string length: 1
Example:

"US"

​
shippingState
string | null

Shipping state

Minimum string length: 1
Example:

"CA"

​
shippingZipCode
string | null

Shipping zip code. Must be 5 digits or 5+4 format.

Pattern: ^\d{5}(-\d{4})?$
Example:

"12345"

​
email
string<email> | null

The email of the customer

Minimum string length: 1
Example:

"john.doe@example.com"

​
externalId
string | null

The external ID of the customer (e.g. the customer ID in your system)

Minimum string length: 1
Example:

"external-customer-id-123"

​
name
string | null

The name of the customer

Minimum string length: 1
Example:

"John Doe"

​
quickBooksId
string | null

The QuickBooks ID of the customer

Minimum string length: 1
Example:

"quickbooks-customer-id-123"

​
stripeId
string | null

The Stripe ID of the customer

Minimum string length: 1
Example:

"stripe-customer-id-123"