v1

latestOpenAPI 3.0.1MIT2026-07-26286592.7 KB

List Merchants

Retrieve a paginated list of all merchants for your account.

get/tax/merchants

Query parameters

limitinteger

Maximum number of merchants to return (max 100)

cursorstring

Pagination cursor from previous response

Headers

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

Response

List of merchants

has_moreboolean

Whether there are more merchants to fetch

last_merchant_idstring

Use as cursor for next page

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"
      }
    }
  ]
}