---
title: "Cancel an Invoice"
method: DELETE
path: "/{invoice_id}"
---

# Cancel an Invoice

`DELETE /{invoice_id}`

## Request

- Base URL: `https://api.tap.company/v2/invoices`
- URL: `https://api.tap.company/v2/invoices/{invoice_id}`
- Auth: API key in header `Authorization`

## Path parameters

- `invoice_id` string, required

## Response `200`

200

- object
  - `object` string
  - `live_mode` boolean
  - `api_version` string
  - `id` string
  - `method` string
  - `status` string
  - `amount` integer
  - `currency` string
  - `created` integer
  - `updated` integer
  - `url` string
  - `draft` boolean
  - `due` integer
  - `expiry` integer
  - `mode` string
  - `description` string
  - `description_id` string
  - `invoice_number` string
  - `frequency` string
  - `lang_code` string
  - `metadata` object
    - `udf1` string
    - `udf2` string
    - `udf3` string
  - `notifications` object
    - `dispatch` boolean
    - `channels` string[]
  - `order` object
    - `object` string
    - `id` string
    - `live_mode` boolean
    - `api_version` string
    - `currency` string
    - `amount` integer
    - `status` string
    - `items` object[]
      - `id` string
      - `product_id` string
      - `name` string
      - `description` string
      - `image` string
      - `currency` string
      - `amount` integer
      - `quantity` integer
      - `discount` object
        - `type` string
        - `value` integer
      - `merchant_id` string
    - `tax` object[]
      - `id` string
      - `name` string
      - `description` string
      - `rate` object
        - `type` string
        - `value` integer
    - `shipping` object
      - `id` string
      - `currency` string
      - `amount` integer
      - `provider` string
      - `service` string
      - `description` string
    - `itemAmount` integer
    - `created` integer
    - `merchant_id` string
  - `reference` object
    - `invoice` string
    - `order` string
  - `customer` object
    - `id` string
    - `first_name` string
    - `middle_name` string
    - `last_name` string
    - `email` string
    - `phone` object
      - `number` string
      - `country_code` string
  - `post` object
    - `url` string
    - `status` string
  - `redirect` object
    - `url` string
  - `charge` object
    - `receipt` object
      - `email` boolean
      - `sms` boolean
    - `statement_descriptor` string
  - `track` object
    - `id` string
    - `object` string
    - `status` string
    - `updated` integer
    - `activity` object[]
      - `id` string
      - `object` string
      - `type` string
      - `created` integer
  - `payment_methods` string[]
  - `currencies` string[]
  - `savecard` boolean
  - `note` string
  - `merchant_id` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/tap/apis/invoices.md) - [All operations](https://skmtc.dev/tap/apis/invoices/llms.txt) - [OpenAPI document](https://skmtc.dev/tap/apis/invoices/revisions/cbf5bdc1152b?raw)