Розробникам

GET/v3/get_document/{uuid}

Отримання реєстраційного профілю

Отримання одного активного профілю, що належить обліковому запису, за UUID його локального документа.

На цій сторінці
  1. Отримання одного збереженого профілю
  2. Запит профілю
  3. Відповідь із профілем
  4. Поля профілю, що повертаються
  5. Профіль не знайдено та повторні спроби

Отримання одного збереженого профілю

Отримайте активний локальний реєстраційний профіль у межах свого облікового запису, вибраний за його UUID. Повертається той самий обмежений набір полів профілю, що й у documents; дані перевірки оператором не оновлюються, а приєднані підтвердні документи не повертаються.

Запит профілю

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

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

Надайте змінній DOCUMENT_UUID значення response.uuid з create_document, або значення response[].id з documents. Не використовуйте тут identity_id, address_id, ID підтвердного документа чи номер телефону. Тіло запиту не потрібне.

Відповідь із профілем

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "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"
  }
}

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

Набір полів, що повертаються, містить 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, посилань на завантажені файли, списків підтвердних документів і статусу перевірки. Ця кінцева точка не призначена для визначення статусу підтвердних документів або схвалення реєстрації. Вважайте отримані ідентифікаційні й контактні дані та дані підпису приватними.

Профіль не знайдено та повторні спроби

Код API 404 із повідомленням Failed, Not found означає, що для цього облікового запису та UUID не знайдено відповідного активного профілю. Перевірте обліковий запис, ідентифікатор і те, чи не було видалено профіль. Цей пошук не розкриває профіль іншого облікового запису.

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