# Quick start

Краткое руководство по началу работы со Statsnet API.

Проверяйте компании, предотвращайте мошенничество и оценивайте риски с помощью одного API. Создавайте безопасные процессы онбординга, проводите комплаенс-проверки и внедряйте мониторинг рисков прямо в свое приложение.

Statsnet создает единый, надежный источник данных о предприятиях в мире. Наша цель — предоставить самые оперативные данные о регистрационных данных, финансовом состоянии и риск-профиле каждого предприятия. Данные, которым можно доверять, получать к ним доступ, анализировать и извлекать, когда и как это необходимо.

Базовый URL API: `https://statsnet.co/api/v1`.

## Шаг 1. Получите API-ключ

Создайте API-ключ (`sk_live_...`) в [личном кабинете](https://statsnet.co/me) — до 10 ключей на аккаунт. Передавайте его в заголовке `Authorization` каждого запроса:

**Заголовок авторизации**

```bash
Authorization: Bearer sk_live_YOUR_KEY
```

Заголовок `x-api-key: sk_live_YOUR_KEY` работает так же. Ключ наследует подписку аккаунта: публичные эндпоинты доступны с любым ключом, платные требуют активный тариф. Подробности — в разделе [Аутентификация](/docs/overview/authentication).

## Шаг 2. Сделайте запрос к API

Найдите компанию, чтобы проверить интеграцию:

**Пример запроса**

```bash
curl -X POST "https://statsnet.co/api/v1/companies/search" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "kaspi", "filters": {"jurisdiction": ["kz"]}}'
```

Затем получите карточку компании по её ID (см. [Get Company](/docs/endpoints/company)):

**Карточка по ID**

```bash
curl "https://statsnet.co/api/v1/companies/12345" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"
```

## Шаг 3. Подключите AI-агента (опционально)

Statsnet доступен и как remote MCP-сервер для AI-агентов — тот же ключ, тот же биллинг. См. [MCP-сервер](/docs/overview/mcp).

## Вопросы?

Мы всегда рады помочь с кодом или другими вопросами, которые могут у вас возникнуть! Не стесняйтесь обращаться по адресу [dev@statsnet.co](mailto:dev@statsnet.co).