v1

latestOpenAPI 3.0.1MIT2026-07-26286592.7 KB

Get Merchant

Retrieve a merchant by internal ID or reference_merchant_id.

get/tax/merchants/{merchant_id}

Path parameters

merchant_idstring required

The merchant ID (merch_xxx) or your reference_merchant_id

Headers

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

Response

Merchant details

idstring

The internal merchant ID

objectstring

reference_merchant_idstring

Your external ID for this merchant

namestring

emailstring

status'active' | 'deleted'

testmodeboolean

Whether this merchant was created in test mode

created_atnumber

Unix timestamp of creation

updated_atnumber

Unix timestamp of last update

Example response

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