Skip to main content
POST
Post a journal entry

Authorizations

Authorization
string
header
required

Authenticate with your secret API key as a bearer token: Authorization: Bearer 3r_live_.... Keys are issued per partner from the dashboard; use 3r_test_... against the sandbox. Never expose a secret key in client-side code.

Headers

Idempotency-Key
string

A unique key (e.g. a UUID) that makes a write safe to retry. Replaying the same key returns the original result instead of creating a duplicate.

Maximum string length: 255

Body

application/json
businessId
string
required
Example:

"biz_9f2"

entries
object[]
required

At least two lines whose debits and credits balance.

Minimum array length: 2
narration
string
Example:

"Office rent — November"

currency
string

ISO 4217 code; defaults to the business base currency.

Example:

"NGN"

date
string<date>

Posting date; defaults to today.

Response

Journal posted.

id
string
required
Example:

"jrnl_7x2a9"

businessId
string
required
Example:

"biz_9f2"

status
enum<string>
required
Available options:
posted,
reversed
Example:

"posted"

balanced
boolean
required
Example:

true

entries
object[]
required
currency
string
Example:

"NGN"

narration
string
Example:

"Office rent — November"

postedAt
string<date-time>
Example:

"2026-11-08T09:24:11Z"