List Merchants
Changed onRetrieve a paginated list of all merchants for your account.
get/tax/merchants
Request
- Base URLhttps://api.numeralhq.com
- URLhttps://api.numeralhq.com/tax/merchants
- AuthHTTP bearer
Query parameters
limitinteger
Maximum number of merchants to return (max 100)
cursorstring
Pagination cursor from previous response
Headers
X-API-Version'2026-03-01' required
Response
List of merchants
Example response
{
"merchants": [
{
"id": "merch_1765503753979c37c5f24",
"object": "tax.merchant",
"reference_merchant_id": "my-seller-123",
"name": "Acme Seller Co",
"email": "seller@example.com",
"default_address": {
"address_line_1": "123 Main St",
"address_line_2": "Suite 100",
"address_city": "San Francisco",
"address_province": "CA",
"address_postal_code": "94105",
"address_country": "US"
},
"tax_ids": [
{
"type": "us_ein",
"value": "12-3456789"
}
],
"status": "active",
"metadata": {
"example_key": "example_value"
}
}
]
}Changes
- breaking
removed the enum value
2026-01-01from theheaderrequest parameterX-API-Version - warning
removed the optional property
from the response with the status - warning
removed the optional property
from the response with the status - info
api operation id
listMerchants_v20260101removed and replaced withlistMerchants_v20260301 - info
added the new enum value
2026-03-01to theheaderrequest parameterX-API-Version - 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
- breaking