NUnumeral-com

Get Merchant

Changed on

Retrieve a merchant by internal ID or reference_merchant_id.

get/tax/merchants/{merchant_id}

Request

  • Base URL
    https://api.numeralhq.com
  • URL
    https://api.numeralhq.com/tax/merchants/{merchant_id}
  • Auth
    HTTP bearer

Path parameters

merchant_idstring required

The merchant ID (merch_xxx) or your reference_merchant_id

Headers

X-API-Version'2026-03-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"
  }
}

Changes

  • f4650eaed11fRevision changes
    • breaking

      removed the enum value 2026-01-01 from the header request parameter X-API-Version

    • info

      api operation id getMerchant_v20260101 removed and replaced with getMerchant_v20260301

    • info

      added the new enum value 2026-03-01 to the header request parameter X-API-Version