Page cover

List Account Requests

Endpoint

GET {{base_url}}/v1/accounts/requests

Description

This endpoint is used to get a list of accounts requested by the organization.

Response

On success, the API will return a JSON object containing the details of the company account.

{
    "status": true,
    "message": "Account requests fetched successfully",
    "data": [
        {
            "id": "523d7cd4-3069-4194-a5dc-667c2c83f391",
            "status": "APPROVED",
            "firstName": "Hamill,",
            "lastName": "Von and Parker",
            "accountType": "CORPORATE",
            "documentData": {
                "mermat": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "certOfInc": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "directors": {
                    "director_1": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "utilityBill",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    },
                    "director_2": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "utilityBill",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    }
                },
                "shareholders": {
                    "shareholder_1": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "utilityBill",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    },
                    "shareholder_2": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "bankStatement",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    }
                }
            },
            "createdAt": "2024-11-07T15:11:35.449Z",
            "companyId": "0ea61db6-da37-472f-bb7d-9114b69dde1d",
            "country": "NG",
            "Account": {
                "id": "78fb5c12-ed6a-44ba-a4a2-7f1122f71b0b",
                "accountName": "Hamill, Von and Parker",
                "accountNumber": "GB12045505050505307",
                "accountBalance": 0,
                "status": "ACTIVE"
            }
            "currency": "EUR"
        },
        {
            "id": "894838c3-5874-40f5-aec3-d4fc9ad2919d",
            "status": "APPROVED",
            "firstName": "Conroy,",
            "lastName": "Rolfson and Mosciski",
            "accountType": "CORPORATE",
            "documentData": {
                "mermat": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "certOfInc": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "directors": {
                    "director_1": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "utilityBill",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    },
                    "director_2": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "utilityBill",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    }
                },
                "shareholders": {
                    "shareholder_1": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "utilityBill",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    },
                    "shareholder_2": {
                        "idFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "idType": "identityCard",
                        "poaFile": "https://xxxxxxxxxxxxxxxxxxxx.png",
                        "poaType": "bankStatement",
                        "idFileBack": "https://xxxxxxxxxxxxxxxxxxxx.png"
                    }
                }
            },
            "createdAt": "2024-11-07T14:31:07.198Z",
            "companyId": "0ea61db6-da37-472f-bb7d-9114b69dde1d",
            "country": "NG",
            "Account": {
                "id": "f162e60d-f93c-43b0-8a54-29ae68645625",
                "accountName": "Conroy, Rolfson and Mosciski",
                "accountNumber": "GB12045505050505311",
                "accountBalance": 0,
                "status": "ACTIVE"
            }
            "currency": "GBP"
        },
        {
            "id": "98623b2e-667a-460d-b032-1b18fbbacafd",
            "status": "APPROVED",
            "firstName": "hENRY",
            "lastName": "ibraheeem",
            "accountType": "USER",
            "documentData": {
                "idType": "identityCard",
                "poaType": "utilityBill",
                "idFileURL": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "poaFileURL": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "idFileBackURL": "https://xxxxxxxxxxxxxxxxxxxx.png"
            },
            "createdAt": "2025-07-21T08:09:07.386Z",
            "companyId": "113b018f-b346-458e-8342-e5ba94b95dca",
            "country": "NG",
            "account": {
                "id": "17722413-4dde-4564-a2a7-f830b1162a53",
                "accountName": "hENRY ibraheeem",
                "accountNumber": "00012469",
                "accountBalance": 0,
                "status": "ACTIVE"
            },
            "currency": "GBP"
        },
        {
            "id": "88bd3acc-46da-4854-9b93-0b207c2cc371",
            "status": "PENDING",
            "firstName": "Kattie",
            "lastName": "Mitchell",
            "accountType": "USER",
            "documentData": {
                "idType": "identityCard",
                "poaType": "utilityBill",
                "idFileURL": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "poaFileURL": "https://xxxxxxxxxxxxxxxxxxxx.png",
                "idFileBackURL": "https://xxxxxxxxxxxxxxxxxxxx.png"
            },
            "createdAt": "2024-11-07T14:24:29.820Z",
            "companyId": "0ea61db6-da37-472f-bb7d-9114b69dde1d",
            "country": "NG",
            "account": null,
            "currency": "EUR"
        }
    ],
    "meta": {
        "total": 4
    },
    "code": 200
}

Last updated