Create Account

POST

/account

This API allows users to create a new account and generates a NUBAN that can be used for interbank transfers.

Request Body

Field Name	Type	Required	Description
name	string	TRUE	The name associated with the account.
bvn	string	TRUE	The Bank Verification Number (BVN) used for identity verification.
groupCode	string	TRUE	A unique code identifying the group to which the account belongs.
accountID	string	TRUE	A system-generated NUBAN that serves as the account's unique identifier and can be used for interbank transactions.

Response Body

Field Name	Type	Description
name	string	The name associated with the created account.
bvn	string	The BVN linked to the account for identity verification.
accountID	string	The NUBAN assigned to the account, which can be used for interbank transfers.
createdDate	string	The timestamp indicating when the account was created.
updatedDate	string	The timestamp indicating the last update made to the account.

Request

Body Params application/json

Example

{
    "name": "POS Agent 131",
    "accountID": "0812345689",
    "bvn": "1235",
    "groupCode": "1UI1KJ118C"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/account' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "POS Agent 131",
    "accountID": "0812345689",
    "bvn": "1235",
    "groupCode": "1UI1KJ118C"
}'

Responses

🟢200Create Account

application/json

Body

Example

{
    "name": "Landmark POS Agents 5 SubLedger",
    "createdDate": "2023-03-22T12:27:46.499+00:00",
    "updatedDate": "2023-03-22T12:27:46.499+00:00",
    "bvn": "12121211221",
    "accountID": "0000000379"
}

Modified at 2025-04-02 07:52:57

Authentication

Rename Account