List Customers

Retrieve a paginated list of all customers

GET /tax/customers

cURL

curl "https://api.numeralhq.com/tax/customers" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-03-01"

curl "https://api.numeralhq.com/tax/customers?cursor=cust_6126acaf-7379-411a-8ada-00005bac0715" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-03-01"

200 - Success

{
  "customers": [
    {
      "id": "cust_6126acaf-7379-411a-8ada-00005bac0715",
      "object": "tax.customer",
      "reference_customer_id": "20506",
      "name": "Customer Name",
      "email": "[e-mail]",
      "is_tax_exempt": false
    },
    {
      "id": "cust_9876543210abcdef",
      "object": "tax.customer",
      "reference_customer_id": "20507",
      "name": "Tax Exempt Customer",
      "email": "[e-mail]",
      "is_tax_exempt": true
    }
  ],
  "has_more": true,
  "last_customer_id": "cust_9876543210abcdef"
}

Retrieve a paginated list of all customers for your account. Deleted customers are not included.

Remember to include the X-API-Version: 2026-03-01 header in your request to use this API version.

Headers

Authorization · string · required

Bearer token authentication.

X-API-Version · string · required

Must be 2026-03-01.

Query Parameters

cursor · string

Pagination cursor from a previous response. Use the last_customer_id from the previous response.

Response

customers · array

Array of customer objects.

has_more · boolean

Whether there are more customers to fetch.

last_customer_id · string

The ID of the last customer in this response. Use as cursor for the next page.

cURL

curl "https://api.numeralhq.com/tax/customers" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-03-01"

curl "https://api.numeralhq.com/tax/customers?cursor=cust_6126acaf-7379-411a-8ada-00005bac0715" \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-03-01"

200 - Success

{
  "customers": [
    {
      "id": "cust_6126acaf-7379-411a-8ada-00005bac0715",
      "object": "tax.customer",
      "reference_customer_id": "20506",
      "name": "Customer Name",
      "email": "[e-mail]",
      "is_tax_exempt": false
    },
    {
      "id": "cust_9876543210abcdef",
      "object": "tax.customer",
      "reference_customer_id": "20507",
      "name": "Tax Exempt Customer",
      "email": "[e-mail]",
      "is_tax_exempt": true
    }
  ],
  "has_more": true,
  "last_customer_id": "cust_9876543210abcdef"
}

Authorizations

Authorization · string · header · required

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

Headers

X-API-Version · enum<string> · required

Available options: 2026-03-01

Query Parameters

cursor · string

Pagination cursor from previous response. Use the last_customer_id from the previous response.

Response

200

application/json

List of customers

customers · object[]

Show child attributes

has_more · boolean

Whether there are more customers to fetch

last_customer_id · string

Use as cursor for next page