Create posting (double-entry)

POST

/v1/core/postings

Last modified:2025-09-07 17:38:45

Maintainer:Not configured

Atomic multi-entry posting.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

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

Token URL: https://auth.nova.bb/oauth2/token

Scopes:

core:postings-Create postings (funds movements).

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409409

🟠422Parameter Error

🟠429429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/core/postings' \
--header 'X-Request-Id;' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "client_ref": "cli_001",
    "uetr": "7b2d2a2e-6b37-4d74-8c1f-8a1a7b9b0a21",
    "value_date": "2025-09-07",
    "entries": [
        {
            "account_id": "acc_sender",
            "direction": "debit",
            "amount": {
                "currency": "BBD",
                "value": "25.00"
            }
        },
        {
            "account_id": "acc_receiver",
            "direction": "credit",
            "amount": {
                "currency": "BBD",
                "value": "25.00"
            }
        }
    ]
}'

Response Example

201 - Example 1

{
    "id": "string",
    "client_ref": "string",
    "uetr": "string",
    "value_date": "2019-08-24",
    "booking_date": "2019-08-24T14:15:22.123Z",
    "state": "posted",
    "entries": [
        {
            "account_id": "string",
            "direction": "debit",
            "amount": {
                "currency": "BBD",
                "value": "50.00"
            },
            "purpose_code": "string",
            "remittance_info": "string"
        }
    ],
    "narration": "string"
}

Modified at 2025-09-07 17:38:45

Get balances

Reverse posting