**06** Endpoints

# Quota usage by market

`GET /v1/usage`

The plan, its term and how much quota is spent — in total and per market. Free: handy before a large import.

Example requests

## Parameters

This request takes no parameters.

## Request `GET`

GET

https://

api.apiauto.space/

v1/

usage

cURL:

```bash
curl -s "https://api.apiauto.space/v1/usage" \
  -H "X-API-Key: $APIAUTO_KEY"
```

JavaScript:

```js
const response = await fetch(
  "https://api.apiauto.space/v1/usage",
  { headers: { "X-API-Key": process.env.APIAUTO_KEY } },
);
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
const data = await response.json();
```

Python:

```python
import os
import httpx

data = httpx.get(
    "https://api.apiauto.space/v1/usage",
    headers={"X-API-Key": os.environ["APIAUTO_KEY"]},
    timeout=30,
).raise_for_status().json()
```

PHP:

```php
<?php
$ch = curl_init("https://api.apiauto.space/v1/usage");
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ["X-API-Key: " . getenv("APIAUTO_KEY")],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
```

## Response

HTTP 200:

```json
{
  "plan": "demo",
  "status": "demo",
  "expires_at": "2026-10-22T12:04:00Z",
  "period": "demo",
  "reset_at": "2026-10-22T12:04:00Z",
  "quota_unit": "requests",
  "quota_limit": 100,
  "quota_used": 3,
  "records_limit": 0,
  "records_used": 0,
  "live_us_limit": 0,
  "live_us_used": 0,
  "by_market": [
    {
      "market": "kr",
      "records": 40,
      "requests": 2,
      "live_us_requests": 0
    },
    {
      "market": "cn",
      "records": 20,
      "requests": 1,
      "live_us_requests": 0
    }
  ]
}
```

## Notes

| Field | Meaning |
| --- | --- |
| `plan, status` | The plan and its state: demo, active or grace (3 days after the end). |
| `expires_at, period, reset_at` | The term's end, the quota period (YYYY-MM or demo) and when it renews. |
| `quota_unit` | records on paid plans, requests on the demo. |
| `quota_limit, quota_used` | The period quota and how much is spent. |
| `records_limit, records_used` | The month's records on paid plans. |
| `live_us_limit, live_us_used` | The live US search counter. |
| `by_market` | Records, requests and live requests per market. |

The sample's values are made up.

---

Page: https://apiauto.space/en/docs/endpoints/usage/