← ExamplesAPI documentation

Ledger API navigation

Delete account

Accounts and transactions · JSON contract

Read specification

Deletes an unused account. An account must have a zero balance and no transactions before it can be deleted.

DELETE/api/accounts/105

Parameters

idinteger · path · required: The identifier of an existing account. Unassigned expense (105) is the eligible seeded example.

Returns

No response body on success. An unknown ID returns 404; an account with financial dependencies returns 409.

Response codes

204: Account deleted. No response body.
404: Unknown account
409: Account has transactions or a non-zero balance

Illustrative API contract. Set $API_ORIGIN to your own backend; this example does not host these endpoints.

Request

cURL

DELETE/api/accounts/105

curl -X DELETE "$API_ORIGIN/api/accounts/105"

Response

Account deleted. No response body.

No response body.

Unknown account

{
  "error": "not_found",
  "message": "The resource does not exist."
}

Account has transactions or a non-zero balance

{
  "error": "account_has_dependencies"
}