> For the complete documentation index, see [llms.txt](https://trust-positif.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trust-positif.gitbook.io/docs/api-reference/usage-stats.md).

# GET /limit & /stats — Usage & quota

Mengembalikan informasi limit/kuota **tanpa** memotong kredit atau mengecek domain.

`GET /stats` identik dengan `GET /limit`.

## Request

```
GET /api/v1/limit
GET /api/v1/stats
```

### Headers

| Header      | Wajib      | Deskripsi                            |
| ----------- | ---------- | ------------------------------------ |
| `Accept`    | Disarankan | `application/json`                   |
| `X-API-Key` | Tidak      | Jika diisi, stats untuk key tersebut |

Tanpa `X-API-Key`, stats berdasarkan **IP klien**.

## Response sukses

**HTTP 200**

```json
{
  "success": true,
  "limit": { }
}
```

Isi `limit` bergantung mode — lihat contoh di bawah.

## Struktur `limit` per mode

### `type: "freemium"`

Tanpa key, atau dengan API key freemium:

```json
{
  "type": "freemium",
  "rate_limit": {
    "limit": 100,
    "used": 25,
    "remaining": 75
  },
  "period": "daily"
}
```

### `type: "premium"`

```json
{
  "type": "premium",
  "quota": {
    "total": 3000,
    "remaining": 2850,
    "used": 150
  },
  "cost_per_request": 3,
  "period": "monthly",
  "package_name": "Professional"
}
```

`cost_per_request: 3` — setiap **domain** di `/check` memakan 3 kredit paket.

## Response error

### 401 — API key invalid

Hanya jika header `X-API-Key` dikirim tapi tidak dikenali.

```json
{
  "success": false,
  "message": "Invalid API key."
}
```

## Kapan memanggil endpoint ini

* Sebelum menjalankan batch / cron harian
* Untuk menampilkan sisa kuota di aplikasi Anda
* Field `stats` pada response `/check` sudah berisi snapshot serupa — endpoint ini untuk cek kuota **tanpa** mengecek domain