Void opening balances

POST https://app.speybooks.com/api/v1/opening-balances/{id}/void

Void an active opening balance journal, setting voided_at on the transaction and marking the import as voided. Does not delete the underlying data — the voided journal remains in the ledger for audit purposes. Restores the ability to re-import opening balances.

Path parameters

id string required

Data import ID (e.g. dimp_2). Must be a completed opening balance import.

Response

200 Journal voided. Returns voided confirmation, transaction ID, and message.

Show response fields

message string

transactionId string

voided boolean

Error codes

404 Completed opening balance import not found, or no active OB journal to void.

Request POST /v1/opening-balances/{id}/void curl

curl -X POST https://api.speybooks.com/v1/opening-balances/dimp_2/void \
  -H "Authorization: Bearer sk_live_..."

Response 200

{
  "success": true,
  "data": {
    "voided": true,
    "transactionId": "txn_891",
    "message": "Opening balance journal voided. You can now import new opening balances."
  }
}