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

get/tax/customers

Request

  • Base URL
    https://api.numeralhq.com
  • URL
    https://api.numeralhq.com/tax/customers
  • Auth
    HTTP bearer

Query parameters

cursorstring

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

Headers

X-API-Version'2026-03-01' required

Response

List of customers

has_moreboolean

Whether there are more customers to fetch

last_customer_idstring

Use as cursor for next page

Example response

{
  "customers": [
    {
      "id": "cust_123456789",
      "object": "tax.customer",
      "reference_customer_id": "20506",
      "name": "Customer Name",
      "email": "customer@example.com",
      "is_tax_exempt": true
    }
  ]
}

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 required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status