List Products

Retrieve a list of up to 50 products. If you have more than 50, you can paginate this endpoint.

GET /tax/products

Try it

cURL

cURL

curl --request GET \
  --url https://api.numeralhq.com/tax/products \
  --header 'Authorization: Bearer <token>'

200

{
  "last_product_id": "p-20507",
  "products": [
    {
      "object": "tax.product",
      "reference_product_id": "p-20506",
      "reference_product_name": "Red T-Shirt",
      "product_category": "CLOTHING",
      "created_at": 1721951003,
      "updated_at": 1721951003,
      "testmode": true
    },
    {
      "object": "tax.product",
      "reference_product_id": "p-20507",
      "reference_product_name": "Blue T-Shirt",
      "product_category": "CLOTHING",
      "created_at": 1721951003,
      "updated_at": 1721951003,
      "testmode": true
    }
  ],
  "has_more": false
}

List Products Endpoint (2025-05-12)

Retrieve a list of products with pagination support.

Remember to include the X-API-Version: 2025-05-12 header in your request to use this API version.

Authorizations

Authorization · string · header · required

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

Query Parameters

cursor · string

The product ID to start pagination from. This is the last product ID retrieved from the previous list request. An example path looks like /tax/products?cursor=p-20506

Response

200

application/json

List of products

has_more · boolean

This will be either true or false depending on if there are more products to be returned in the next request.

Example:

"false"

last_product_id · string

The ID of the last product returned in the response. This can be used as a cursor for pagination.

Example:

"p-20507"

products · object[]

Show child attributes

products. object · string

The type of object: tax.product.

Example:

"tax.product"

products. reference_product_id · string

The ID of the created product

Example:

"p-20506"

products. reference_product_name · string

The name of the created product

Example:

"Red Shoes"

products. product_category · string

The category of the created product

Example:

"CLOTHING_GENERAL"

products. created_at · number

Epoch datetime representing the date and time the product was created

Example:

1721694425

products. updated_at · number

Epoch datetime representing the date and time the product was last updated

Example:

1721694425

products. testmode · boolean

True if using a production API key. False if using a test API key.

Example:

"true"