List manual journals or create a draft
API Documentation / Resources / Journals

List manual journals
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals
Required OAuth scope: manualjournals:read
Lists subsidiary manual journal drafts and posted results.
| Filter | Meaning |
|---|---|
status |
Return DRAFT or POSTED entries only. |
from_date |
Journal date on or after this date. |
to_date |
Journal date on or before this date. |
updated_since |
Changed at or after an RFC 3339 timestamp. |
Results are ordered by journal date descending, then by stable resource order. Posted journals remain available for audit but cannot be edited.
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. |
status |
query | No | string: DRAFT, POSTED | |
from_date |
query | No | string (date) | |
to_date |
query | No | string (date) | |
updated_since |
query | No | string (date-time) | |
page |
query | No | integer | |
per_page |
query | No | integer: 25, 50, 100 |
Request
GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Responses
| Status | Description |
|---|---|
200 |
A page of manual journals. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
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": []
},
{
"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"
}
],
"meta": {
"current_page": 1,
"per_page": 25,
"last_page": 1,
"total": 1
}
}
Create a manual journal draft
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals
Required OAuth scope: manualjournals:write
Creates an editable draft containing at least two lines.
Amount convention
| Sign | Accounting effect |
|---|---|
| Positive | Debit |
| Negative | Credit |
| Zero | Rejected |
Amounts are decimal strings with up to four fractional digits. Each
dimension_element_ids entry must belong to a distinct active dimension.
The draft can be saved before posting, but its signed gross total must be
zero before the post operation succeeds.
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. |
Request
POST /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/manual-journals HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}
Content-Type: application/json
{
"date": "2026-08-31",
"narration": "Monthly consulting accrual",
"external_source": "month-end",
"external_reference": "ACCRUAL-2026-08",
"lines": [
{
"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"
]
},
{
"account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c34",
"amount": "-1200.0000",
"description": "Accrued expenses",
"tax_rate_id": null,
"dimension_element_ids": []
}
]
}
Required body fields: date, narration, lines.
Responses
| Status | Description |
|---|---|
201 |
Draft manual journal created. |
401 |
Access token is missing, expired, revoked, or invalid. |
403 |
Token lacks the required scope or granted accounting context. |
422 |
Journal data, balance, references, or accounting period failed validation. |
201 example
HTTP/1.1 201 Created
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"
}
}