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

# Delete Merchant

`DELETE /tax/merchants/{merchant_id}`

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

---

[API](https://skmtc.net/numeral-com/apis/numeral-api.md) · [All operations](https://skmtc.net/numeral-com/apis/numeral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/numeral-com/numeral-api/revisions/f0af51c3f9b9/schema)