---
title: "Delete credit note"
description: "Deletes a credit note permanently, as the dashboard does. The credited invoice is untouched and a new credit note can be raised for it afterwards. (An invoice created by mistake has its own permanent delete: DELETE /docu"
url: https://docs.invoicefalcon.com/v3-reference/documents/delete-credit-note/
api: "API v3 reference"
method: DELETE
path: "/documents/credit_notes/{id}"
---

# Delete credit note

`DELETE https://app.invoicefalcon.com/api/v3/external/documents/credit_notes/{id}`

Deletes a credit note permanently, as the dashboard does. The credited invoice is untouched and a new credit note can be raised for it afterwards. (An invoice created by mistake has its own permanent delete: [`DELETE /documents/invoices/:id/permanent`](https://docs.invoicefalcon.com/v3-reference/documents/destroy-invoice/).)

**Note:** Permanent: the document, its PDF and its history are removed. Cannot be undone. Send it first without `confirm`: nothing changes and the 409 `confirmation_required` says what would. Tell the merchant, ask, and resend with `confirm: true` (`?confirm=true` on a DELETE) only after they agree.

## Path parameters

- `id` (string, required)

## Query parameters

- `confirm` (boolean): Send true only after the merchant agreed. Without it nothing is deleted and the 409 says what would be.

## Returns

- `id` (integer): e.g. `980190964`
- `deleted` (boolean): e.g. `true`

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Example request

```sh
curl -X DELETE "https://app.invoicefalcon.com/api/v3/external/documents/credit_notes/980191059" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
```

## 200

The updated resource.

```json
{
  "id": 980190964,
  "deleted": true
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 404

The resource does not exist for this shop, or no action is registered at this path.

```json
{
  "errors": [
    "Resource not found"
  ],
  "code": "not_found"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

