rkl — Проверка по реестру контролируемых лиц

POST https://api.newdb.net/v2

Метод выполняет проверку лица по форме сервиса Госуслуг "Реестр контролируемых лиц".

Заголовки

Content-Type: application/json
X-API-KEY: <your_token>

Пример параметров запроса (params)

Ниже пример в формате, который фактически передается в spider (params_raw):

params_raw = json.dumps({
    "method": "rkl",
    "country": "ru",
    "lastname": "Иванов",
    "firstname": "Иван",
    "secondname": "Иванович",
    "dob_info": "01.2002",
    "issue_date": "31.01.2002",
    "id_doc_seria": "FA",
    "id_doc_number": "2001901",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003"
})

Для dob_info = "01.2002" spider выберет режим частичной даты рождения "Месяц и год" (optional = "3"), год 2002, месяц 1 (в форме: Янв 2002).

Пример API-запроса

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "lastname": "Иванов",
    "firstname": "Иван",
    "secondname": "Иванович",
    "dob_info": "01.2002",
    "issue_date": "31.01.2002",
    "id_doc_seria": "FA",
    "id_doc_number": "2001901",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003"
  },
  "requestId": "optional-string",
  "webhook": "https://your.host/webhook"
}

Пример API-запроса (dob_info = только год)

Для dob_info = "2002" spider выберет режим "Только год" (optional = "2"), в форме будет выбран год 2002.

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "lastname": "Иванов",
    "firstname": "Иван",
    "secondname": "Иванович",
    "dob_info": "2002",
    "issue_date": "31.01.2002",
    "id_doc_seria": "FA",
    "id_doc_number": "2001901",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003-year"
  },
  "requestId": "optional-string",
  "webhook": "https://your.host/webhook"
}

Пример API-запроса (dob_info = полная дата)

Для dob_info = "31.01.2002" spider выберет режим "Полная дата" (optional = "1"), поле даты рождения будет заполнено значением 31012002.

{
  "params": {
    "method": "rkl",
    "country": "ru",
    "lastname": "Иванов",
    "firstname": "Иван",
    "secondname": "Иванович",
    "dob_info": "31.01.2002",
    "issue_date": "31.01.2002",
    "id_doc_seria": "FA",
    "id_doc_number": "2001901",
    "newdb_qid": "EKYiIMO21ZnJMygA",
    "taskId": "test-rkl-003-full-date"
  },
  "requestId": "optional-string",
  "webhook": "https://your.host/webhook"
}

Входные параметры (params)

{
  "method": "rkl",
  "country": "ru",
  "lastname": "string",
  "firstname": "string",
  "secondname": "string",
  "dob_info": "string",
  "issue_date": "string",
  "id_doc_seria": "string",
  "id_doc_number": "string",
  "taskId": "string"
}

Основные поля:

• id_doc_seria — серия документа.
• id_doc_number — номер документа (обязательное поле).
• issue_date — дата выдачи документа (обязательное поле, нормализуется в DD.MM.YYYY).
• dob_info — дата рождения в полном или частичном формате (подробно ниже).

dob_info: как парсится

Поле dob_info поддерживает несколько форматов. По нему spider определяет, какой режим даты рождения выбрать в форме.

Поддерживаемые форматы:

• DD.MM.YYYY (также допускаются разделители -, /) -> полная дата рождения.
• MM.YYYY (также MM-YYYY, MM/YYYY) -> месяц и год рождения.
• YYYY -> только год рождения.
• YYYY.MM / YYYY-MM / YYYY-MM-DD /YYYY/MM -> также принимается для обратной совместимости и трактуется как год+месяц.

Примеры

• dob_info = "01.2002" -> режим "Месяц и год", в форме: Янв 2002
• dob_info = "2002" -> режим "Только год", в форме: 2002
• dob_info = "31.01.2002" -> режим "Полная дата", в форме поле даты: 31012002

Пример ответа

Ниже пример структуры ответа NEWDB для метода rkl. Значение registry_status определяется из текста результата на экране Госуслуг:

• not_found — если в заголовке найдено "отсутствует в реестре контролируемых лиц"
• found — если в заголовке найдено "в реестре контролируемых лиц"
• unknown — если статус не удалось определить по заголовку

{
  "params": {
    "params": {
      "method": "rkl",
      "country": "ru",
      "lastname": "Иванов",
      "firstname": "Иван",
      "secondname": "Иванович",
      "dob_info": "01.2002",
      "issue_date": "31.01.2002",
      "id_doc_seria": "FA",
      "id_doc_number": "2001901",
      "newdb_qid": "EKYiIMO21ZnJMygA",
      "taskId": "test-rkl-003"
    }
  },
  "requestId": "optional-string",
  "state": "complete",
  "results": {
    "rkl": {
      "taskId": "test-rkl-003",
      "dateupdated": "2026-02-25 12:00:00",
      "result": {
        "status": 200,
        "data": [
          {
            "title": "Сведения о проверяемом лице отсутствуют в реестре контролируемых лиц",
            "details": [
              "Проверка выполнена по данным документа и дате рождения."
            ],
            "raw": "Сведения о проверяемом лице отсутствуют в реестре контролируемых лиц Проверка выполнена по данным документа и дате рождения.",
            "registry_status": "not_found"
          }
        ]
      }
    }
  }
}