Skip to main content
GET
/
customers
/
{customer_id}
Retrieve a customer
curl --request GET \
  --url https://api.salesbricks.com/api/v2/customers/{customer_id} \
  --header 'X-SALESBRICKS-KEY: <api-key>'
{
  "customer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "legal_name": "<string>",
  "subscriptions": [
    {
      "subscription_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "starts_at": "2023-12-25",
      "ends_at": "2023-12-25"
    }
  ],
  "external_id": "<string>",
  "address": {
    "line_1": "<string>",
    "city": "<string>",
    "zip": "<string>",
    "country": "<string>",
    "line_2": "<string>",
    "region": "<string>"
  },
  "stripe_customer_id": "<string>",
  "tax_id": "<string>"
}

Authorizations

​
X-SALESBRICKS-KEY
string
header
required

API key for authentication

Path Parameters

​
customer_id
string
required
Pattern: ^([a-zA-Z\d\-]+)$

Response

Customer output serializer; we can represent the customer model differently depending on the request so we need a custom serializer for the output.

​
customer_id
string<uuid>
required
​
name
string
required
​
legal_name
string
required
read-only
​
subscriptions
object[]
required
read-only

List of subscriptions associated with this customer

​
external_id
string | null
Maximum string length: 255
​
address
object

The address of the customer

​
stripe_customer_id
string | null

The companies stripe customer_id

Maximum string length: 255
​
tax_id
string | null

Tax identification number (e.g., EIN, VAT number)