Výpis registračních profilů

Vyhledání existujících registračních profilů

Vypište aktivní, nesmazané místní registrační profily přiřazené k vašemu účtu API. Tento výpis použijte k nalezení UUID profilu před jeho otevřením pomocí get_document, nikoli ke zjištění, zda byly schváleny jeho doklady nebo registrace čísla.

Požadavek na výpis

Ověřte se pomocí svého aktivovaného účtu API MultiTEL a jeho povolené IP adresy. Příklady používají přihlašovací údaje pro HTTP Basic uložené v proměnných prostředí. Zkontrolujte jak odpověď HTTP, tak pole v JSON status.code; samotná odpověď HTTP 200 nepotvrzuje úspěch. Všechny hodnoty v příkladech jsou smyšlené.

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

Tato obslužná funkce neimplementuje tělo požadavku, stránkování ani parametry filtrování. Vrací uložené profily příslušného účtu; nepředpokládejte konkrétní pořadí. U rozsáhlých účtů se vyhněte častému opakovanému načítání celého seznamu.

Seznam v odpovědi

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

Pokud nejsou nalezeny žádné odpovídající aktivní profily, obslužná funkce vrátí kód API 200 a prázdný seznam v odpovědi. response[].id je UUID místního profilu vrácené při vytvoření jako uuid; nejde o ID identity ani o ID adresy.

Vrácená pole profilu

Výběr polí obsahuje 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 a date_created.

Volitelné hodnoty mohou být podle uložených dat prázdné nebo mít hodnotu null. Tento výběr polí původního rozhraní vynechává email, pole pro výběr země, identity_id, address_id, odkazy na nahrané soubory, seznamy dokladů a stav ověření. Nejde o koncový bod pro zjišťování stavu dokladů ani schválení registrace. S vrácenými údaji o identitě, kontaktními údaji a údaji o podpisu zacházejte jako se soukromými.

Další kroky

Uložte si ID entit z původní odpovědi volání create_document pro pozdější připojování. Pokud se tato odpověď ztratila, tento seznam neumožňuje tato ID obnovit. Prohlédněte si profil na portálu nebo kontaktujte podporu místo automatického vytváření duplikátu.