GET
/
api
/
v1
/
customer
/
{customer_uuid}
curl --request GET \
  --url https://api.justpaid.io/api/v1/customer/{customer_uuid} \
  --header 'Authorization: Bearer <token>'
{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "name": "John Doe",
  "email": "john.doe@example.com",
  "external_id": "CUST-001",
  "billing_address": {
    "street": "123 Main St",
    "city": "Anytown",
    "state": "CA",
    "postal_code": "12345",
    "country": "US"
  },
  "shipping_address": {
    "street": "456 Elm St",
    "city": "Othertown",
    "state": "NY",
    "postal_code": "67890",
    "country": "US"
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

customer_uuid
string
required

Response

200
application/json
Customer retrieved successfully

Schema for retrieving customer information.

Attributes: uuid (UUID): The unique identifier for the customer. name (str): The name of the customer. contact_name (Optional[str]): The name of the contact person for the customer. email (Optional[str]): The primary email address of the customer. additional_emails (Optional[List[str]]): A list of additional email addresses for the customer. billing_emails (Optional[List[str]]): A list of email addresses used for billing purposes. phone_number (Optional[str]): The customer's phone number, including country code. currency (Optional[str]): The currency used by the customer. tax_id (Optional[str]): The customer's tax identification number. billing_address (Optional[AddressSchema]): The customer's billing address. shipping_address (Optional[AddressSchema]): The customer's shipping address. external_id (Optional[str]): An external identifier for the customer, aliased as 'external_customer_id'.

uuid
string

The unique identifier for the customer.

Example:

"123e4567-e89b-12d3-a456-426614174000"

name
string

The name of the customer.

Example:

"John Doe"

contact_name
string | null

The name of the contact person for the customer.

Example:

"John Doe"

email
string | null

The primary email address of the customer.

Example:

"john.doe@example.com"

additional_emails
string[] | null

A list of additional email addresses for the customer.

Example:
[
  "john.doe@example.com",
  "jane.doe@example.com"
]
billing_emails
string[] | null

A list of email addresses used for billing purposes.

Example:
[
  "john.doe@example.com",
  "jane.doe@example.com"
]
phone_number
string | null

The customer's phone number, including country code.

Example:

"+1234567890"

currency
string | null

The currency used by the customer.

Example:

"USD"

tax_id
string | null

The customer's tax identification number.

Example:

"1234567890"

billing_address
object | null

The customer's billing address.

shipping_address
object | null

The customer's shipping address.

external_id
string | null

An optional external identifier for the customer. This can be used to link the customer to an external system.

Example:

"CUST-001"