Lista profili rejestracyjnych

Znajdź istniejące profile rejestracyjne

Wyświetl listę aktywnych, nieusuniętych lokalnych profili rejestracyjnych powiązanych z Twoim kontem API. Użyj jej, aby znaleźć UUID profilu przed otwarciem go za pomocą get_document, a nie do ustalania, czy dokumenty potwierdzające dane profilu lub rejestracja numeru zostały zatwierdzone.

Żądanie pobrania listy

Uwierzytelnij się przy użyciu aktywowanego konta API MultiTEL, korzystając z dozwolonego dla niego adresu IP. Przykłady wykorzystują dane uwierzytelniające HTTP Basic przechowywane w zmiennych środowiskowych. Sprawdź zarówno odpowiedź HTTP, jak i pole JSON status.code; sama odpowiedź HTTP 200 nie oznacza powodzenia. Wszystkie przykładowe wartości są fikcyjne.

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

Ta procedura obsługi nie implementuje treści żądania, stronicowania ani parametrów filtrowania. Zwraca zapisane profile właściwego konta; nie zakładaj określonej kolejności. W przypadku dużych kont unikaj częstego, cyklicznego pobierania pełnej listy.

Lista w odpowiedzi

{
  "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"
    }
  ]
}

Jeśli nie ma pasujących aktywnych profili, procedura obsługi zwraca kod API 200 i pustą listę w odpowiedzi. response[].id to UUID lokalnego profilu zwracany jako uuid podczas tworzenia; nie jest to identyfikator tożsamości ani identyfikator adresu.

Zwracane pola profilu

Zwracany zestaw pól obejmuje 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 i date_created.

Wartości opcjonalne mogą być puste lub mieć wartość null, zależnie od zapisanych danych. Ten zestaw pól ze starszej implementacji pomija email, pola wyboru kraju, identity_id, address_id, odwołania do przesłanych plików, listy dokumentów potwierdzających dane oraz status weryfikacji. Ten punkt końcowy nie służy do sprawdzania statusu dokumentów potwierdzających dane ani zatwierdzenia rejestracji. Traktuj zwracane dane dotyczące tożsamości, kontaktu i podpisu jako prywatne.

Dalsze kroki

Zachowaj identyfikatory encji z pierwotnej odpowiedzi create_document do późniejszego dołączania elementów. Jeśli ta odpowiedź została utracona, ta lista nie pozwoli odzyskać tych identyfikatorów. Sprawdź profil w portalu lub skontaktuj się z pomocą techniczną zamiast automatycznie tworzyć duplikat.