Список реєстраційних профілів

Пошук наявних реєстраційних профілів

Отримайте список активних, невидалених локальних реєстраційних профілів, пов’язаних із вашим обліковим записом API. Використовуйте його, щоб знайти UUID профілю перед відкриттям за допомогою get_document, а не для визначення того, чи було схвалено його підтвердні документи або реєстрацію номера.

Запит на отримання списку

Пройдіть автентифікацію за допомогою свого активованого облікового запису API MultiTEL з дозволеної для нього IP-адреси. У прикладах використовуються облікові дані HTTP Basic, збережені у змінних середовища. Перевіряйте як відповідь HTTP, так і поле JSON status.code; сама лише відповідь HTTP 200 не підтверджує успішного виконання. Усі значення в прикладах вигадані.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/documents

Цей обробник не підтримує тіло запиту, поділ на сторінки чи параметри фільтрації. Він повертає збережені профілі відповідного облікового запису; не слід розраховувати на певний порядок. Для великих облікових записів уникайте частого опитування з отриманням повного списку.

Список у відповіді

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": [
    {
      "id": "11111111111111111111111111111111",
      "first_name": "Example",
      "last_name": "Person",
      "phone_number": "12025550123",
      "id_number": "",
      "birth_date": null,
      "company_name": "",
      "company_reg_number": "",
      "vat_id": "",
      "personal_tax_id": "",
      "description": "Example profile",
      "identity_type": "Personal",
      "postal_code": "00000",
      "city": "Example City",
      "address": "1 Example Street",
      "signature": "BASE64_PNG_SIGNATURE_DATA",
      "date_created": "2026-10-23 16:00:00"
    }
  ]
}

Якщо відповідних активних профілів немає, обробник повертає код API 200 і порожній список у відповіді. response[].id — це UUID локального профілю, який повертається як uuid під час створення; це не ідентифікатор особи чи адреси.

Поля профілю, що повертаються

Вибірка полів містить id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature та date_created.

Необов’язкові значення можуть бути порожніми або мати значення null залежно від збережених даних. Ця застаріла вибірка полів не містить email, полів вибору країни, identity_id, address_id, посилань на завантажені файли, списків підтвердних документів і статусу перевірки. Ця кінцева точка не призначена для отримання статусу підтвердних документів або схвалення реєстрації. Ставтеся до повернутих ідентифікаційних і контактних даних та даних підпису як до конфіденційних.

Подальші дії

Збережіть ідентифікатори сутностей із початкової відповіді create_document для подальших прив’язувань. Якщо цю відповідь було втрачено, відновити їх за допомогою цього списку неможливо. Перегляньте профіль на порталі або зверніться до служби підтримки замість автоматичного створення дубліката.