Retrieve an account's daily payout limit status

GET

/account-limits/{account_id}

Fetches the current daily transfer limit configuration and consumption for an account, scoped to the authenticated entity. The response includes the applicable limit value and where it was resolved from (account-level override vs entity-level default), how much has already been paid out successfully today (UTC calendar day), and the remaining headroom. For Nigerian entities whose KYC requirement set includes a proof-of-address field, the response also reports whether submitting proof of address unlocks a higher limit and the current submission status of that requirement.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Responses

🟢200

application/json

Account limit status resolved and returned successfully.

Bodyapplication/json

🟠400

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location '/account-limits/01HQZR2BKPFQ8MXJVT3G7LWNE' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "message": "Account limit status retrieved successfully",
    "status": "success",
    "data": {
        "account_id": "01HQZR2BKPFQ8MXJVT3G7LWNE",
        "entity_id": "01HQZR2BKPFQ8MXJVT3G7LWNA",
        "currency": "NGN",
        "limit": {
            "value": 5000000,
            "scope": "entity"
        },
        "used_today": 1250000,
        "remaining_today": 3750000,
        "proof_of_address": {
            "applicable": true,
            "status": "not_submitted",
            "unlocks_limit": 10000000
        }
    }
}

Modified at 2026-09-30 00:29:45

Retrieve an account

Create an API key