finov.ioDocumentationHome

Get, update, or delete a manual journal

API Documentation / Resources / Journals

Saved manual journal detail showing Draft status and balanced debit and credit totals
A saved draft remains editable and has not affected the general ledger.

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.