> ## Documentation Index
> Fetch the complete documentation index at: https://docs.krdata.pl/llms.txt
> Use this file to discover all available pages before exploring further.

# Rozliczanie

> Jedna pula jednostek, koszt endpointów, nadwyżka i limit wydatków.

API jest dostępne w planach **API** i **Enterprise**. Plan Premium obejmuje wyłącznie panel. Ceny: [krdata.pl/cennik](https://krdata.pl/cennik).

Każde płatne wywołanie zużywa jednostki z jednej puli. Koszt konkretnego endpointu znajdziesz na końcu jego opisu w **API Reference**.

| Plan       | Jednostki w cenie            | Nadwyżka                                  |
| ---------- | ---------------------------- | ----------------------------------------- |
| API        | 3 000 na okres rozliczeniowy | 0,05 zł / jednostkę, do 1 000 zł na okres |
| Enterprise | bez limitu                   | warunki indywidualne                      |

Okres rozliczeniowy to okres subskrypcji Stripe. Nadwyżka trafia na kolejną fakturę.

## Koszt endpointów

| Endpointy                                                                                                                                    | Koszt                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
| `/record`, `/v1/search`, `/v1/graph`, `/v1/risk`, `/v1/krs/changes/{id}`, `/v1/rdf/documents`, `/v1/rdf/financials`, słowniki i podsumowania | 1 jednostka za wywołanie                     |
| `/records` (do 50 identyfikatorów)                                                                                                           | 1 jednostka za każdy zwrócony rekord         |
| `/stream` i endpointy listowe (KRZ, MSiG, BZP, KNF, UOKiK, SUDOP)                                                                            | 1 jednostka za każdy zwrócony rekord         |
| `/v1/krs/changes/stream`                                                                                                                     | 1 jednostka za każde rozpoczęte 10 zmian     |
| `/v1/wpv/records`                                                                                                                            | 1 jednostka za każde rozpoczęte 10 sprawdzeń |
| Dokumenty: `/v1/krs/pdf`, `/v1/crbr/pdf`, `/v1/uokik/documents/{id}`, `/v1/rdf/documents/{id}`                                               | 10 jednostek za dokument                     |
| `/v1/rdf/archive` (ZIP, tylko Enterprise)                                                                                                    | 10 jednostek za każde sprawozdanie           |

`/stream` z `limit=1000`, który zwróci 1000 rekordów, zużyje 1000 jednostek. Pobrania z panelu są bezpłatne.

Nie zużywają jednostek endpointy pomocnicze (`/v1/usage/*`, `/v1/monitors*`, `/v1/monitor-events`, `/v1/updates`, `/v1/filters`, `/v1/reports/*`, `/v1/bzp/alerts`, `/v1/bzp/cpv`, `/v1/msig/issues`).

## Limit wydatków i okres próbny

* **Limit wydatków** na nadwyżkę ustawiasz w **Panel → Ustawienia → Użycie** (domyślnie 1 000 zł). Po jego osiągnięciu API zwraca `402` do końca okresu. Większe wolumeny obsługujemy w planie Enterprise.
* **Okres próbny** trwa 14 dni na pierwszej subskrypcji. W tym czasie pula wynosi 200 jednostek, bez nadwyżki. Trial można zakończyć wcześniej w panelu.

## Stan puli

```bash theme={null}
curl https://api.krdata.pl/v1/usage/api \
  -H "x-api-key: $KRDATA_API_KEY"
```

* `GET /v1/usage/api` – zużycie, jednostki w cenie planu, nadwyżka, limit wydatków i zakres okresu.
* `GET /v1/usage/daily` – zużycie dzień po dniu.
* `GET /v1/usage/breakdown` – zużycie per endpoint.
* `GET /v1/usage/keys` – zużycie per klucz API.

## Kod 402

`HTTP 402 Payment Required` oznacza brak aktywnego planu z API, osiągnięty limit wydatków albo limit okresu próbnego – szczegóły w polu `detail`. Limit podniesiesz w **Panel → Ustawienia → Użycie**, plan zmienisz w **Panel → Abonament**.