Add New Journal

Production

POST

/journals{format}

Creates a manual journal entry. Send the Journal header fields and the JournalTransaction[] double-entry lines. The total debit of the lines must equal the total credit, and at least one line is required. Amounts are supplied per line via currency_debit / currency_credit (in the journal currency); the base-currency debit/credit and the journal totals are calculated automatically. The journal date must fall within an open financial period.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Header Params

Body Params application/json

Examples

Responses

🟢202Accepted

application/json

Created

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location '/journals' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Journal": {
        "date": "2026-05-10",
        "description": "Manual adjustment",
        "currency_code": "SAR",
        "draft": 1,
        "manual_currency_rate": 0.2
    },
    "JournalTransaction": [
        {
            "journal_account_id": 125,
            "currency_debit": 1500,
            "currency_credit": 0,
            "description": "Cash1",
            "tax_id": 1
        },
         {
            "journal_account_id": 373,
            "currency_debit": 0,
            "currency_credit": 1500,
            "description": "Cash2",
            "tax_id": 1
        }
    ]
}'

Response Example

202 - Example 1

{
    "result": "successful",
    "code": 202,
    "id": 2415
}

GET Single Journal

GET All Journal Accounts