---
title: "Delete a credit"
method: DELETE
path: "/public/v1/credits/{id}"
tags: ["Credit"]
---

# Delete a credit

`DELETE /public/v1/credits/{id}`

Soft-delete a credit. The credit is marked as deleted and stops appearing in this API and the
Distru UI, but the record is retained rather than being permanently removed, so its history is
preserved. Returns 204 with no body on success.

A credit cannot be deleted once it has been used (has at least one active application to an
invoice). Overpayment credits (created from an invoice overpayment or a QuickBooks Online
payment) cannot be deleted unless they have already been canceled — void the associated payment
instead. Either case returns an error.

If your account syncs credits with QuickBooks Online, the deletion is also pushed to QuickBooks
Online in the background; a 204 confirms the delete in Distru, not that the QuickBooks Online
side has finished.

Required permission: `credits_permissions_delete`. The authenticated user must also have access
to the credit under their team restrictions.

## Path parameters

- `id` string, required

## Response `204`

No Content

## Other responses

- `400` — Invalid parameters
- `401` — Missing or invalid API token
- `403` — The API token lacks the required permission
- `404` — Not Found

---

[API](https://skmtc.dev/distru/apis/distru-api.md) · [All operations](https://skmtc.dev/distru/apis/distru-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/distru/distru-api/revisions/eb775b7b6ee0/schema)