List registreringsprofiler

Finn eksisterende registreringsprofiler

List de aktive lokale registreringsprofilene som er knyttet til API-kontoen din og ikke er slettet. Bruk dette til å finne en profils UUID før du åpner den med get_document, ikke til å avgjøre om dokumentasjonen eller nummerregistreringen er godkjent.

Forespørsel om liste

Autentiser deg med den aktiverte MultiTEL API-kontoen din og kontoens tillatte IP-adresse. Eksemplene bruker påloggingsopplysninger for HTTP Basic lagret i miljøvariabler. Kontroller både HTTP-svaret og JSON-feltet status.code; et HTTP-svar med kode 200 alene bekrefter ikke at forespørselen var vellykket. Alle eksempelverdiene er fiktive.

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

Denne forespørselsbehandleren har ingen implementert støtte for forespørselskropp, paginering eller filterparametere. Den returnerer de lagrede profilene til den aktuelle kontoen; ikke forutsett noen bestemt rekkefølge. Unngå å hente hele listen ofte for store kontoer.

Svarliste

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

Hvis det ikke finnes noen samsvarende aktive profiler, returnerer forespørselsbehandleren API-kode 200 og en tom svarliste. response[].id er den lokale profilens UUID, som returneres som uuid ved opprettelse; det er ikke en identitets-ID eller adresse-ID.

Profilfelter som returneres

Feltutvalget inneholder 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 og date_created.

Valgfrie verdier kan være tomme eller null, avhengig av de lagrede dataene. Dette feltutvalget fra den eldre løsningen utelater email, landvelgere, identity_id, address_id, referanser til opplastede filer, dokumentasjonslister og verifiseringsstatus. Dette er ikke et endepunkt for dokumentasjonsstatus eller godkjenning av registrering. Behandle identitets-, kontakt- og signaturopplysningene som returneres, som private.

Neste steg

Lagre enhets-ID-ene fra det opprinnelige create_document-svaret for senere tilknytninger. Hvis dette svaret er gått tapt, kan ikke denne listen hente ID-ene tilbake. Se gjennom profilen i portalen eller kontakt kundestøtte i stedet for å opprette en duplikatprofil automatisk.