Get, update, or delete a manual journal
API Documentation / Resources / Journals

Get a manual journal
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id}
Required OAuth scope: manualjournals:read
Returns the complete draft or posted record, including normalized lines and the immutable journal identifier created by posting when applicable.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the bank account. |
manual_journal_id |
path | Yes | string (uuid) | UUID of a manual journal draft. |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
Manual journal details. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
404 |
Manual journal does not exist in the granted accounting context. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": "8bbcf430-b958-4575-89fd-a7cbb17e9114",
"date": "2026-08-31",
"narration": "Monthly consulting accrual",
"description": null,
"contact_id": null,
"external_source": "month-end",
"external_type": null,
"external_reference": "ACCRUAL-2026-08",
"status": "DRAFT",
"balance": "0.0000",
"journal_id": null,
"lines": [
{
"id": "d5e8ef74-f021-45d0-b4b0-778d324be162",
"account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c33",
"amount": "1200.0000",
"description": "Consulting expense",
"tax_rate_id": null,
"dimension_element_ids": [
"db77df9b-f7bd-467b-9f75-fb18de743742"
]
},
{
"id": "7f28bfee-0509-4a55-a23b-2b60576ec094",
"account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c34",
"amount": "-1200.0000",
"description": "Accrued expenses",
"tax_rate_id": null,
"dimension_element_ids": []
}
],
"posted_at": null,
"created_at": "2026-08-10T14:00:00Z",
"updated_at": "2026-08-10T14:00:00Z"
}
}
Update a manual journal draft
PATCH /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id}
Required OAuth scope: manualjournals:write
Updates supplied fields on a draft. Omitted fields remain unchanged.
Supplying lines replaces the complete line collection, so send every
line that should remain. A posted manual journal is immutable and returns
409 manual_journal_posted; correct it through the journal reversal
lifecycle instead.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the bank account. |
manual_journal_id |
path | Yes | string (uuid) | UUID of a manual journal draft. |
Request
PATCH /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"narration": "August consulting accrual"
}
Required body fields: None.
Responses
| Status | Description |
|---|---|
200 |
Updated draft. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
404 |
Manual journal does not exist in the granted accounting context. |
409 |
Manual journal state does not permit the requested transition. |
422 |
Journal data, balance, references, or accounting period failed validation. |
200 example
HTTP/1.1 200 OK
Content-Type: application/json
{
"data": {
"id": "8bbcf430-b958-4575-89fd-a7cbb17e9114",
"date": "2026-08-31",
"narration": "Monthly consulting accrual",
"description": null,
"contact_id": null,
"external_source": "month-end",
"external_type": null,
"external_reference": "ACCRUAL-2026-08",
"status": "DRAFT",
"balance": "0.0000",
"journal_id": null,
"lines": [
{
"id": "d5e8ef74-f021-45d0-b4b0-778d324be162",
"account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c33",
"amount": "1200.0000",
"description": "Consulting expense",
"tax_rate_id": null,
"dimension_element_ids": [
"db77df9b-f7bd-467b-9f75-fb18de743742"
]
},
{
"id": "7f28bfee-0509-4a55-a23b-2b60576ec094",
"account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c34",
"amount": "-1200.0000",
"description": "Accrued expenses",
"tax_rate_id": null,
"dimension_element_ids": []
}
],
"posted_at": null,
"created_at": "2026-08-10T14:00:00Z",
"updated_at": "2026-08-10T14:00:00Z"
}
}
Delete a manual journal draft
DELETE /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id}
Required OAuth scope: manualjournals:write
Permanently deletes an unposted draft and its draft lines.
Posted entries cannot be deleted through this resource. Their accounting effect must be corrected using the journal lifecycle so the audit trail remains intact.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
tenant_id |
path | Yes | string (uuid) | UUID of the authorized company group. |
subsidiary_id |
path | Yes | string (uuid) | UUID of the subsidiary whose books contain the bank account. |
manual_journal_id |
path | Yes | string (uuid) | UUID of a manual journal draft. |
Request
DELETE /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals/{manual_journal_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
204 |
Draft deleted. The response has no body. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
404 |
Manual journal does not exist in the granted accounting context. |
409 |
Manual journal state does not permit the requested transition. |