Delete Merchant

Soft delete a merchant

DELETE /tax/merchants/{merchant_id}

cURL

curl -X DELETE https://api.numeralhq.com/tax/merchants/my-seller-123 \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-03-01"

200 - Success

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

{
  "error": {
    "error_code": "merchant_not_found",
    "error_message": "Merchant not found or belongs to different testmode"
  }
}

{
  "error": {
    "error_code": "merchant_not_found",
    "error_message": "Merchant not found or belongs to different testmode"
  }
}

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-03-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

curl -X DELETE https://api.numeralhq.com/tax/merchants/my-seller-123 \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "X-API-Version: 2026-03-01"

200 - Success

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

{
  "error": {
    "error_code": "merchant_not_found",
    "error_message": "Merchant not found or belongs to different testmode"
  }
}

{
  "error": {
    "error_code": "merchant_not_found",
    "error_message": "Merchant not found or belongs to different testmode"
  }
}

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

200

application/json

Merchant deleted successfully

id · string

Example:

"merch_1765503753979c37c5f24"

object · string

Example:

"tax.merchant"

deleted · boolean

Example:

true

deleted_at · number

Unix timestamp of deletion