Delete Debt

{
  "error": false,
  "message": "Debt deleted successfully"
}

Overview

This endpoint permanently removes a debt from your system. Use with caution as this action cannot be undone.

Authentication

Requires a valid OAuth 2.0 access token with the debts:write scope.

Example Request

curl -X DELETE "/external-api/v1/debts/abc123def456" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

const debtId = 'abc123def456';

const response = await fetch(`/external-api/v1/debts/${debtId}`, {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
  }
});

const result = await response.json();

Success Response

{
  "error": false,
  "message": "Debt deleted successfully"
}

Important Notes

Permanent Action: Deleting a debt is irreversible. All associated followups and history will also be removed.

All followups associated with this debt will be deleted
Payment history will be preserved for accounting purposes
Reports that include this debt will show it as “deleted”
Consider updating the status instead of deleting for record-keeping

Error Responses

{
  "error": true,
  "message": "Access denied to this debt",
  "code": 403
}

{
  "error": true,
  "message": "Debt not found or invalid ID",
  "code": 404
}

Get started

Guides

SFTP integration

Company API

Creditors API

Debtors API

Debts API

Timelines API

Campaigns API

Settings API

Invoice documents API

Followups API

Todos API

Status API

Overview

Authentication

Example Request

Success Response

Important Notes

Error Responses

​Overview

​Authentication

​Example Request

​Success Response

​Important Notes

​Error Responses

Overview

Authentication

Example Request

Success Response

Important Notes

Error Responses