Get Wallet Balance

Retrieve the authenticated business wallet balance that is available for settlements and payouts.

Endpoint

GET

/api/v1/wallet/balance

Send

Authorization

BearerAuth

AuthorizationBearer

In: header

Response Body

200 application/json

400 application/json

401 application/json

403 application/json

422 application/json

500 application/json

503 application/json

cURL Example

curl -X GET "https://atlas.tryduplo.com/api/v1/wallet/balance" \
  -H "Authorization: Bearer "

Sample Responses

200 OK

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Fetch Wallet details.",
  "statusCode": 200,
  "data": {
    "availableBalance": {
      "value": 20000,
      "currency": "NGN",
      "formatted": "NGN 200.00"
    }
  }
}

400 Bad Request

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Bad request.",
  "statusCode": 400
}

401 Unauthorized

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Invalid API key.",
  "statusCode": 401
}

403 Forbidden

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Forbidden.",
  "statusCode": 403
}

422 Unprocessable Entity

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Validation error.",
  "statusCode": 422
}

500 Internal Server Error

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "An error occurred while processing your request.",
  "statusCode": 500
}

503 Service Unavailable

{
  "requestId": "f006ad7b-096c-4254-8c7e-2d23a55b0b0e",
  "requestTimestamp": "2025-09-04 11:49:40",
  "message": "Banking service is temporarily unavailable.",
  "statusCode": 503
}