Delete Merchant

Changed on

Soft delete a merchant. The merchant will no longer appear in GET/LIST operations.

delete/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 deleted successfully

idstring
objectstring
deletedboolean
deleted_atnumber

Unix timestamp of deletion

Example response

{
  "id": "merch_1765503753979c37c5f24",
  "object": "tax.merchant",
  "deleted": true
}

Changes

    • breaking

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

    • info

      api operation id deleteMerchant_v20260101 removed and replaced with deleteMerchant_v20260301

    • info

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