Извеждане на списък с регистрационни профили

Намиране на съществуващи регистрационни профили

Изведете списък с активните, неизтрити локални регистрационни профили, свързани с вашия API акаунт. Използвайте го, за да намерите UUID на профил, преди да го отворите с get_document, а не за да установите дали удостоверителните му документи или регистрацията на номера са одобрени.

Заявка за списъка

Удостоверете се с активирания си 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/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 за последващо прикачване. Ако този отговор е изгубен, идентификаторите не могат да бъдат възстановени чрез този списък. Прегледайте профила в портала или се свържете с екипа за поддръжка, вместо автоматично да създавате дубликат.