Get Balance - Numero

Retrieve your merchant account balance. Supports multiple currencies.

Endpoint

GET /api/v1/business/balance

Signature required: No

Headers

Header	Required	Description
`x-api-key`	Yes	Your API key

Query parameters

Parameter	Type	Required	Default	Description
`currency`	string	No	`NGN`	Currency code (e.g., `NGN`, `USD`)

Request example

curl -X GET "https://api-dev.usenumero.com/numeroaccount/api/v1/business/balance?currency=NGN" \
  -H "x-api-key: your_api_key"

Response

{
  "status": true,
  "message": "Successful",
  "code": "200",
  "version": "v1",
  "reference": "abc123",
  "data": {
    "balance": 1500000.00,
    "ledgerBalance": 1550000.00,
    "totalHolds": 50000.00,
    "availableBalance": 1450000.00,
    "currency": "NGN"
  },
  "error": null
}

Field	Type	Description
`balance`	number	Current book balance
`ledgerBalance`	number	Total ledger balance including pending transactions
`totalHolds`	number	Amount currently held (e.g., pending approvals)
`availableBalance`	number	Balance available for transactions (`balance - totalHolds`)
`currency`	string	Currency of the balance

Cardholder Transactions Get Transactions

⌘I

​Endpoint

​Headers

​Query parameters

​Request example

​Response

Endpoint

Headers

Query parameters

Request example

Response