# Top-up information

`GET /v1/addfunds` · scope `billing:read`

Minimum and maximum top-up amounts and the payment gateways available.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/v1/addfunds` |
| Method | `GET` |
| Scope | `billing:read` |
| Header | `Authorization: Bearer <token>` |
| Content-Type | — (no body) |
| Tokens that can call it | app tokens (`tinoat_`), personal API tokens (`tinopat_`) |

## Parameters

This route takes no parameters.

## Example request

```bash
curl "https://api.tino.vn/v1/addfunds" \
  -H "Authorization: Bearer $TINO_TOKEN"
```

`$TINO_TOKEN` is a token with the scope `billing:read`.

SDK ([SDK & examples](/en/docs/sdk)): Python `client.billing.get_add_funds_info()`, Node.js `await client.billing.getAddFundsInfo();`, PHP `$client->billing->getAddFundsInfo();`.

## Example response

```json
{
 "min_amount": 50000,
 "max_amount": 500000000,
 "gateways": [
  {
   "id": 190,
   "name": "Thanh toán bằng chuyển khoản - QR Code - Momo - ZaloPay"
  },
  {
   "id": 70,
   "name": "Ví điện tử MoMo"
  },
  "… 2 more item(s)"
 ]
}
```

Live sample from a test account with personal data masked; long arrays and strings are trimmed (`… N more item(s)`, `… N more line(s)`).