# Fraim Tenders API V2

> HTTP API по тендерам и контрактам России (44-ФЗ, 223-ФЗ, коммерческие торги): поиск закупок, живые ленты изменений по сохранённому фильтру, карточки тендеров и контрактов, история по ИНН заказчика и поставщика. Только server-to-server, авторизация Bearer-токеном, оплата — за доставленный объект, а не за запрос.

Base URL: `https://public.fraim.ru/api/v2`. Авторизация: `Authorization: Bearer <token>`.
Поиск и ленты — `POST /tenders/query` и `POST /contracts/query`, пагинация только курсорная.
Оплата — за первую доставку версии объекта, не за запрос. Только server-to-server: CORS отключён.

## Документация

- [AI-документация одним файлом](https://api.fraim.ru/ai.md): полное описание API для агента — модель данных, биллинг, все 16 эндпоинтов, коды ошибок, примеры. Начните отсюда.
- [OpenAPI 3.1](https://public.fraim.ru/api/v2/openapi.json): машинная схема, из которой сгенерирован справочник.
- [Та же AI-документация страницей](https://api.fraim.ru/ai): HTML-версия того же текста.
- [Документация для людей](https://api.fraim.ru/docs): развёрнутые объяснения и примеры.

## Эндпоинты

- **Auth**: `GET /auth/tokens`, `POST /auth/tokens`, `DELETE /auth/tokens/{token_id}`
- **Tenders**: `POST /tenders/query`, `GET /tenders/{tender_id}`
- **Contracts**: `POST /contracts/query`, `GET /contracts/{contract_id}`
- **Lists**: `GET /lists`, `POST /lists`, `GET /lists/{list_id}`, `POST /lists/{list_id}/items`, `DELETE /lists/{list_id}/items`
- **Filters**: `GET /filters`, `DELETE /filters/{filter_id}`
- **Balance**: `GET /balance`, `GET /balance/ledger`

## Аккаунт

- [Личный кабинет](https://lk.api.fraim.ru): регистрация, выпуск API-токенов, баланс, песочница на демо-данных (токены `fraim_test_…`).