Dezvoltatori

GET/v3/documents

Listarea profilurilor de înregistrare

Găsiți profilurile locale active ale contului folosind proiecția limitată de câmpuri din versiunea veche.

Pe această pagină
  1. Găsiți profilurile de înregistrare existente
  2. Cererea de listare
  3. Lista din răspuns
  4. Câmpurile de profil returnate
  5. Pașii următori

Găsiți profilurile de înregistrare existente

Listați profilurile locale de înregistrare active și neșterse asociate contului dumneavoastră API. Folosiți această listă pentru a găsi UUID-ul unui profil înainte de a-l deschide cu get_document, nu pentru a stabili dacă documentele sale justificative sau înregistrarea numărului au fost aprobate.

Cererea de listare

Autentificați-vă folosind contul dumneavoastră API MultiTEL activat și adresa IP permisă pentru acesta. Exemplele folosesc date de autentificare HTTP Basic stocate în variabile de mediu. Verificați atât răspunsul HTTP, cât și câmpul JSON status.code; un răspuns HTTP 200 nu confirmă singur reușita. Toate valorile din exemple sunt fictive.

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

Această componentă de procesare nu implementează un corp al cererii, paginare sau parametri de filtrare. Returnează profilurile stocate ale contului corespunzător; nu presupuneți că acestea au o anumită ordine. Pentru conturile mari, evitați solicitarea frecventă a listei complete.

Lista din răspuns

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

Dacă nu există profiluri active corespunzătoare, componenta de procesare returnează codul API 200 și o listă goală în răspuns. response[].id este UUID-ul profilului local, returnat ca uuid la creare; nu este un ID de identitate sau un ID de adresă.

Câmpurile de profil returnate

Proiecția conține 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.

Valorile opționale pot fi goale sau null, în funcție de datele stocate. Această proiecție din versiunea veche omite email, selectoarele de țară, identity_id, address_id, referințele la fișierele încărcate, listele de documente justificative și starea verificării. Acesta nu este un endpoint pentru starea documentelor justificative sau aprobarea înregistrării. Tratați datele de identitate, de contact și de semnătură returnate ca fiind confidențiale.

Pașii următori

Salvați ID-urile entităților din răspunsul inițial al create_document pentru atașări ulterioare. Dacă acel răspuns s-a pierdut, această listă nu poate recupera ID-urile. Examinați profilul în portal sau contactați serviciul de asistență în loc să creați automat un duplicat.