Finance OS / API

Отчёты и PDF

Каждая проверка сохраняется под своим id и доступна для повторного чтения — в JSON и в виде готового PDF. Прямая ссылка на PDF приходит в поле report_url каждого ответа.

✦
Не тарифицируется повторно
Перечитывание отчёта (GET) и выгрузка PDF не расходуют квоту и не создают новую проверку. Храните id из ответа создания и переиспользуйте его — не вызывайте POST повторно для одного и того же адреса, иначе создастся новая (тарифицируемая) проверка.

Список проверок

GET /api/v1/aml/checks
⚷ Bearer Token

Последние проверки текущего окружения

Возвращает до 100 последних проверок вашего контура в текущем окружении (sandbox или live, по префиксу ключа), новые — первыми. Каждый элемент имеет ту же форму, что и ответ создания.

Responses

{
  "data": [
    {
      "id": "b7e4c1a2-3f5d-4e8a-9c1b-2d6f7a8e0b3c",
      "address": "TXYZ1234567890abcdefGHIJKLmnop",
      "network": "tron",
      "risk_score": 64,
      "risk_level": "high",
      "report": { "...": "полный отчёт, как в ответе создания" },
      "pricing": { "markup_pct": 0 },
      "report_url": "https://fin-os.io/api/v1/aml/checks/b7e4c1a2-3f5d-4e8a-9c1b-2d6f7a8e0b3c/report.pdf",
      "created_at": "2026-07-13T10:24:00+00:00"
    }
  ]
}

Пагинации нет — возвращаются 100 последних записей. Для собственной истории сохраняйте проверки на своей стороне по id.

Одна проверка

GET /api/v1/aml/checks/{id}
⚷ Bearer Token

Получить сохранённую проверку по id

id — это id из ответа создания. Проверка ищется в скоупе вашего контура и текущего окружения; чужие или не из этого окружения — 404. Возвращается сохранённый снимок, повторная оценка не выполняется.

Responses

{
  "data": {
    "id": "b7e4c1a2-3f5d-4e8a-9c1b-2d6f7a8e0b3c",
    "address": "TXYZ1234567890abcdefGHIJKLmnop",
    "network": "tron",
    "risk_score": 64,
    "risk_level": "high",
    "report": { "...": "полный отчёт, как в ответе создания" },
    "pricing": { "markup_pct": 0 },
    "report_url": "https://fin-os.io/api/v1/aml/checks/b7e4c1a2-3f5d-4e8a-9c1b-2d6f7a8e0b3c/report.pdf",
    "created_at": "2026-07-13T10:24:00+00:00"
  }
}

PDF-отчёт

GET /api/v1/aml/checks/{id}/report.pdf
⚷ Bearer Token

Скачать обезличенный отчёт в PDF

Возвращает PDF-файл (Content-Disposition: attachment, имя aml-report-{id}.pdf) — тот же обезличенный отчёт в печатной форме, готовый для комплаенс-архива. Требует тот же Bearer-ключ, что и остальные вызовы (ссылка report_url не публичная). Прямая ссылка приходит в поле report_url каждой проверки.
ℹ
Что внутри PDF
Печатный отчёт содержит те же обезличенные данные, что и JSON: итоговый risk_score / risk_level / рекомендацию, сигналы, факторы и агрегаты по сетям. Имена внутренних источников данных не раскрываются. Подходит для приложения к комплаенс-делу.