finov.ioDocumentationHome

List manual journals or create a draft

API Documentation / Resources / Journals

Manual journal editor containing a balanced two-line imported journal
Review every imported value and confirm the gross balance before saving.

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"
  }
}