finov.ioDocumentationHome

Get a posted journal

API Documentation / Resources / Journals

Posted manual journal detail with linked ledger journal and posting history
Posting creates the linked ledger journal and makes the financial entry immutable.

Get a posted journal

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/journals/{journal_id}

Required OAuth scope: accounting:read

Returns a posted journal with normalized signed lines and audit history.

Contract Behavior
Positive line amount Debit.
Negative line amount Credit.
Source fields Identify the workflow that created the posting.
Correction Use the source lifecycle or a reversal; amounts are immutable.

Journals outside the granted subsidiary context are not disclosed.

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 containing the ledger.
journal_id path Yes string (uuid) UUID of the posted journal.

Request

GET /v1/tenants/{tenant_id}/subsidiaries/{subsidiary_id}/journals/{journal_id} HTTP/1.1
Host: api.finov.io
Authorization: Bearer {access_token}

Responses

Status Description
200 Posted journal details.
401 Access token is missing, expired, revoked, or invalid.
403 Token lacks the required scope or granted accounting context.
404 Journal does not exist in the granted accounting context.

200 example

HTTP/1.1 200 OK
Content-Type: application/json

{
  "data": {
    "id": "553aa91a-e8c2-4c6f-b800-07a2b92efdb1",
    "journal_number": "JRN-2026-0082",
    "date": "2026-08-10",
    "source": "invoice",
    "source_id": "f54ca5ce-c915-417b-9514-818ba58a21cb",
    "contact_id": "a68d68ec-5866-42e5-8864-57829d3f91b5",
    "currency_code": "NZD",
    "exchange_rate": "1.00000000",
    "gross": "1725.0000",
    "narration": "Sales invoice INV-2026-0042",
    "lines": [
      {
        "id": "9dbf18ab-f3d5-4ee7-a985-091960377b7b",
        "account_id": "f159c40d-d09c-44a8-85f1-6ba96ca583ee",
        "account_code": "1100",
        "description": "Accounts receivable",
        "amount": "1725.0000",
        "tax_rate_id": null,
        "dimension_element_ids": []
      },
      {
        "id": "55d27ea8-8f48-4822-8be4-87dcc536aadc",
        "account_id": "a110c7ae-3208-4f93-a64c-d2ba9dd82c31",
        "account_code": "4100",
        "description": "Advisory services",
        "amount": "-1500.0000",
        "tax_rate_id": "d98226c2-ad80-4345-b117-5630de766842",
        "dimension_element_ids": []
      },
      {
        "id": "6f2785d3-78a4-4777-8e39-fe306823d9c7",
        "account_id": "992483c2-6ad3-46a6-8ce8-a6423ed8061f",
        "account_code": "2200",
        "description": "GST payable",
        "amount": "-225.0000",
        "tax_rate_id": "d98226c2-ad80-4345-b117-5630de766842",
        "dimension_element_ids": []
      }
    ],
    "history": [
      {
        "type": "POSTED",
        "description": "Posted from invoice INV-2026-0042.",
        "created_at": "2026-08-10T13:30:00Z"
      }
    ],
    "posted_at": "2026-08-10T13:30:00Z",
    "updated_at": "2026-08-10T13:30:00Z"
  }
}