Vis registreringsprofiler

Find eksisterende registreringsprofiler

Vis de aktive lokale registreringsprofiler, der er knyttet til din API-konto og ikke er slettet. Brug dette til at finde en profils UUID, før du åbner den med get_document, ikke til at afgøre, om dens dokumentation eller nummerregistrering blev godkendt.

Anmodning om liste

Godkend dig med din aktiverede MultiTEL API-konto og dens tilladte IP-adresse. Eksemplerne bruger legitimationsoplysninger til HTTP Basic, som er gemt i miljøvariabler. Kontrollér både HTTP-svaret og JSON-feltet status.code; et HTTP-svar med status 200 er ikke i sig selv bevis på, at anmodningen lykkedes. Alle eksempelværdier er fiktive.

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

Denne handler understøtter hverken en anmodningskrop, sideinddeling eller filterparametre. Den returnerer den matchende kontos gemte profiler; du må ikke forudsætte en bestemt rækkefølge. Undgå hyppig polling af hele listen for store konti.

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 der ikke er nogen matchende aktive profiler, returnerer handleren API-koden 200 og en tom svarliste. response[].id er den lokale profils UUID, som returneres som uuid ved oprettelsen; det er hverken et identitets-ID eller et adresse-ID.

Returnerede profilfelter

Feltudvalget indeholder 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 værdier kan være tomme eller null afhængigt af de gemte data. Dette feltudvalg fra den ældre implementering udelader email, landevælgere, identity_id, address_id, referencer til uploadede filer, lister over dokumentation og verifikationsstatus. Det er ikke et endpoint til at kontrollere dokumentationsstatus eller godkendelse af registreringer. Behandl de returnerede identitets-, kontakt- og signaturdata som private oplysninger.

Næste trin

Gem entitets-ID'er fra det oprindelige create_document-svar til senere tilknytninger. Hvis dette svar er gået tabt, kan denne liste ikke genskabe dem. Undersøg profilen i portalen eller kontakt support i stedet for automatisk at oprette en dublet.