# Statsnet API

REST API поверх тех же данных, что и сайт. База: https://statsnet.co/api/v1

## Аутентификация

Заголовок `x-api-key: sk_live_...`. Ключи создаются в личном кабинете (до 10 на аккаунт). Ключ наследует подписку владельца: без активного платного плана ключ даёт доступ только к публичным эндпоинтам.

## Публичные эндпоинты (без ключа)

- GET /companies/{id}/meta/beta — карточка компании (JSON)
- GET /companies/{jurisdiction}/{identifier}/meta/beta — по БИН/ИИН (kz | uz | kg)
- GET /companies/{jurisdiction}/{identifier}/md — карточка в Markdown
- GET /companies/states/{jurisdiction} — регионы

## Платные эндпоинты (ключ с подпиской; 1 отчёт за компанию, повтор в течение 2 недель бесплатно)

- GET /companies/{id}/paid — полная карточка
- GET /companies/{id}/contacts — контакты (маскированные; полные значения через reveal)
- GET /companies/{id}/gov-contracts, /quasi_contracts — госконтракты
- GET /companies/{id}/relations — граф связей
- GET /individuals/{identifier} — карточка физлица
- POST /export — массовые выгрузки

Коды ответов: 402 — подписка неактивна, 429 — квота периода исчерпана, 403 — нет доступа. Тарифы: https://statsnet.co/pricing.md

## Swagger

https://statsnet.co/api/v1/swagger/index.html