---
title: "Delete Merchant"
method: DELETE
path: "/tax/merchants/{merchant_id}"
---

# Delete Merchant

`DELETE /tax/merchants/{merchant_id}`

## Request

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

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

## Path parameters

- `merchant_id` string, required

## Headers

- `X-API-Version` '2026-03-01', required

## Response `200`

Merchant deleted successfully

- MerchantDeleteResponse
  - `id` string
  - `object` string
  - `deleted` boolean
  - `deleted_at` number: Unix timestamp of deletion

## Other responses

- `404`: Merchant not found

## Changes

- **2026-11-03** `f4650eaed11f`: 1 breaking, 2 info
  - removed the enum value `2026-01-01` from the `header` request parameter `X-API-Version`
  - api operation id `deleteMerchant_v20260101` removed and replaced with `deleteMerchant_v20260301`
  - added the new enum value `2026-03-01` to the `header` request parameter `X-API-Version`

[Operation history](https://skmtc.dev/numeral-com/apis/numeral-api/changes/tax/merchants/:merchant_id/delete.md)

---

[API](https://skmtc.dev/numeral-com/apis/numeral-api.md) - [All operations](https://skmtc.dev/numeral-com/apis/numeral-api/llms.txt) - [OpenAPI document](https://skmtc.dev/numeral-com/apis/numeral-api/revisions/f4650eaed11f?raw)