Request User Account

Endpoint

POST {{base_url}}/v1/accounts/request-account

Description

This endpoint is used to create a new user account. The default currency is EUR with other currencies supported, see currencies list.

Request Body

The request body should be a form-data object containing the following fields:

• firstName: "John",

• lastName: "Doe",

• countryShort: "NG" ,

  (Acceptable country shorts are ; UK, FR, DE, IT, ES, NG, BJ, ML, TG, CI, US. See more)

• idType: "identityCard", (See list of acceptable ID Types by country)

• poaType: "utilityBill", (See list of acceptable POA Types)

• idFile: "idFile.jpeg",

• idFileBack: "idFileBack.jpeg",

Non-passport ID types (identity card, driving license, and residence permit) require an "idFileBack" field for a successful request.

• poaFile: "utility.jpeg",

• currency: "GBP",

Important Notes

• ID and POA type identifiers are case-sensitive. Click here to learn more.

• File upload size limit is 500KB

• Acceptable file extensions are : ".jpeg", ".jpg", ".png", ".pdf"

Example Request

Field	Type	Value
firstName	string	John
lastName	string	Doe
countryShort	string	NG
idType	string	identityCard
idFile	file	idCard.jpg
idFileBack	file	idback.jpeg
poaType	string	utilityBill
poaFile	file	utilityBill.pdf
currency	string	GBP

Response

The API will return a JSON object containing the details of the account request. There are two possible response outcomes, reflecting the status of the business account :

• Trusted Business Response: This indicates the business account has been fully verified. The requestStatus will typically be INPROGRESS and, after successful issuance, status will transition to APPROVED.

• Untrusted Business Response: This indicates the business account is still undergoing verification or has limited capabilities. The requestStatus will be PENDING for this type of response, signifying that certain actions may require manual approval until full verification is achieved.

Below are sample responses:

(GBP)Trusted Account Response

{
    "status": true,
    "message": "GBP account issuance request submitted successfully",
    "data": {
        "id": "13d1fcb5-c5a3-4372-91c6-9260295c31fb",
        "requestStatus": "INPROGRESS",
        "firstName": "John",
        "lastName": "Doe",
        "currency": "GBP",
        "requestAccountType": "USER",
        "requestDocuments": {
            "idType": "identityCard",
            "poaType": "utilityBill",
            "idFileURL": "https://xxxxxxxxxxxxxxxxxxxx/national-id.jpeg",
            "idFileBackURL": "https://xxxxxxxxxxxxxxxxxxxx/natIDback.png"
            "poaFileURL": "https://xxxxxxxxxxxxxxxxxxxx/aecd-bill.jpeg"
        },
        "issuingCompanyId": "113b018f-b346-458e-8342-e5ba94b95dca",
        "createdAt": "2025-07-23T19:29:51.876Z"
    },
    "code": 202
}

(EUR)Trusted Account Response

(GBP)Untrusted Account Response

Error Responses

Include common error responses and their meanings.

• 400 Bad Request: One or more fields are missing or invalid.

• 500 Internal Server Error: An error occurred on the server.