Open account (step-up required)

POST

/v1/accounts

Opens a new account immediately when account type allows user self-service. Requires step-up (account:open) via X-Step-Up-Token. Body: account_type_id, currency, optional credit_limit for credit products.

Authentication: Bearer JWT (user session). Step-up: X-Step-Up-Token required for operation account:open.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

API Key

Add parameter in header

X-Step-Up-Token

Example:

X-Step-Up-Token: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Account opened

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/accounts' \
--header 'X-Step-Up-Token;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "account_type_id": "baf55510-832d-4f74-9f92-e025da90456f",
    "currency": "str",
    "credit_limit": "string"
}'

Response Example

201 - Example 1

{
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "account_number": "string",
    "currency": "string",
    "status": "active",
    "balance": "string",
    "available_balance": "string",
    "credit_limit": "string",
    "account_type": {},
    "opened_at": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-06-23 04:24:01

List user accounts

Aggregated balance history across accounts