> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/api-reference/account/get-balance.md).

# Get Balance

Use this endpoint to retrieve the current balance associated with your Taqnyat account.

### Endpoint

```
GET /account/balance/
```

Full URL:

```
https://api.taqnyat.sa/wa/v2/account/balance/
```

### Authentication

Include your Bearer Token in the request header:

```
Authorization: Bearer <YOUR_TOKEN>
```

### Example Request

```
curl --location 'https://api.taqnyat.sa/wa/v2/account/balance/' \
--header 'Authorization: Bearer <YOUR_TOKEN>'
```

### Request Body

This endpoint does not require a request body.

### Example Response

```
{
  "balance": "<CURRENT_BALANCE>"
}
```

> The exact response fields and value format should match the response returned by the production API.

### Response Fields

| Field     | Type            | Description                                |
| --------- | --------------- | ------------------------------------------ |
| `balance` | Number / String | Current available balance for the account. |

### Possible Errors

#### 401 Unauthorized

Returned when the Bearer Token is missing or invalid.

```
HTTP/1.1 401 Unauthorized
```

Verify that the `Authorization` header contains a valid token:

```
Authorization: Bearer <YOUR_TOKEN>
```

### Notes

* This is a read-only endpoint.
* No request payload is required.
* The balance returned reflects the account balance available at the time of the request.