Skip to main content
DELETE
/
tax
/
merchants
/
{merchant_id}
curl -X DELETE https://api.numeralhq.com/tax/merchants/my-seller-123 \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-01-01"

{
  "id": "merch_1765503753979c37c5f24",
  "object": "tax.merchant",
  "deleted": true,
  "deleted_at": 1735690500
}
Soft delete a merchant. The merchant will no longer appear in GET or LIST operations but the data is preserved internally.
Deleted merchants cannot be used in new platform calculations. Attempting to use a deleted merchant’s ID will return a merchant_not_found error.

​
Headers

​
Authorization
string
required
Bearer token authentication.
​
X-API-Version
string
required
Must be 2026-01-01.

​
Path Parameters

​
merchant_id
string
required
The merchant ID (merch_xxx) or your reference_merchant_id.

​
Response

​
id
string
The merchant ID.
​
object
string
Always tax.merchant.
​
deleted
boolean
Always true for successful deletion.
​
deleted_at
number
Unix timestamp of deletion.
curl -X DELETE https://api.numeralhq.com/tax/merchants/my-seller-123 \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-01-01"

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

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
X-API-Version
enum<string>
required
Available options:
2026-01-01

Path Parameters

​
merchant_id
string
required

The merchant ID (merch_xxx) or your reference_merchant_id

Response

Merchant deleted successfully

​
id
string
Example:

"merch_1765503753979c37c5f24"

​
object
string
Example:

"tax.merchant"

​
deleted
boolean
Example:

true

​
deleted_at
number

Unix timestamp of deletion