curl --request POST \
--url https://staging-api.tyms.io/v1/adam/bills/{uuid}/void \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{}'{
"status": "success",
"message": "This record has been voided.",
"data": {
"uuid": "cc0e8400-e29b-41d4-a716-446655440008",
"void_date": "2026-11-03",
"void_journal_no": 1042
}
}Void bill
Void a posted bill. Unmatch a bank transaction linked to a payment on this bill before you void it.
Void a record that is already on the books. Tyms keeps the record and posts the reverse of its ledger lines. Send an empty body to void it today.
date cannot be in the future, inside a closed period, or before the record and any activity already posted. reason is optional and is stored up to 500 characters. It is required when the record was approved and the void must be approved again. In that case the record stays as it is until someone approves the void, and the response includes void_pending: true.
A record that is not on the books yet can be deleted instead. A record that is already voided cannot be voided again. Opening balances cannot be voided.
curl --request POST \
--url https://staging-api.tyms.io/v1/adam/bills/{uuid}/void \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '{}'{
"status": "success",
"message": "This record has been voided.",
"data": {
"uuid": "cc0e8400-e29b-41d4-a716-446655440008",
"void_date": "2026-11-03",
"void_journal_no": 1042
}
}Authorizations
Body
Optional. An empty body voids the record today.
Response
The record was voided, or the void was sent for approval.