# 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 <token>

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

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

## Sample Responses

### 200 OK

```json
{
  "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

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

### 401 Unauthorized

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

### 403 Forbidden

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

### 422 Unprocessable Entity

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

### 500 Internal Server Error

```json
{
  "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

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