Lista registreringsprofiler

Hitta befintliga registreringsprofiler

Lista de aktiva lokala registreringsprofiler som är kopplade till ditt API-konto och inte har raderats. Använd detta för att hitta en profils UUID innan du öppnar den med get_document, inte för att avgöra om dess styrkande handlingar eller nummerregistrering har godkänts.

Listbegäran

Autentisera dig med ditt aktiverade MultiTEL API-konto och dess tillåtna IP-adress. Exemplen använder inloggningsuppgifter för HTTP Basic som lagras i miljövariabler. Kontrollera både HTTP-svaret och JSON-fältet status.code; ett HTTP-svar med koden 200 räcker inte i sig för att fastställa att begäran lyckades. Alla exempelvärden är fiktiva.

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

Den här hanteraren har inget stöd för begärandekropp, sidindelning eller filterparametrar. Den returnerar det matchande kontots lagrade profiler; förutsätt inte någon viss ordning. Undvik att ofta hämta hela listan för stora konton.

Svarslista

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

Om det inte finns några matchande aktiva profiler returnerar hanteraren API-koden 200 och en tom svarslista. response[].id är den lokala profilens UUID som returneras som uuid när profilen skapas; det är inte ett identitets-ID eller adress-ID.

Returnerade profilfält

Fälturvalet innehåller 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 och date_created.

Valfria värden kan vara tomma eller null beroende på lagrade data. Detta fälturval från den äldre implementationen utelämnar email, landsväljare, identity_id, address_id, referenser till uppladdade filer, listor över styrkande handlingar och verifieringsstatus. Det är inte en ändpunkt för att kontrollera status för styrkande handlingar eller godkännande av registrering. Behandla de returnerade identitets-, kontakt- och signaturuppgifterna som privata.

Nästa steg

Spara entitets-ID:n från det ursprungliga svaret från create_document för senare kopplingar. Om det svaret har gått förlorat kan denna lista inte återskapa dessa ID:n. Granska profilen i portalen eller kontakta supporten i stället för att automatiskt skapa en dubblett.