Registrierungsprofile auflisten

Vorhandene Registrierungsprofile finden

Listen Sie die aktiven, nicht gelöschten lokalen Registrierungsprofile auf, die Ihrem API-Konto zugeordnet sind. Verwenden Sie diese Liste, um die UUID eines Profils zu finden, bevor Sie es mit get_document öffnen, und nicht, um festzustellen, ob seine Nachweise oder seine Rufnummernregistrierung genehmigt wurden.

Anfrage zum Auflisten

Authentifizieren Sie sich mit Ihrem aktivierten MultiTEL-API-Konto und der dafür zugelassenen IP-Adresse. Die Beispiele verwenden in Umgebungsvariablen gespeicherte Zugangsdaten für HTTP Basic. Prüfen Sie sowohl die HTTP-Antwort als auch das JSON-Feld status.code; eine HTTP-Antwort mit dem Status 200 allein belegt keinen Erfolg. Alle Beispielwerte sind fiktiv.

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

Dieser Handler implementiert weder einen Anfragekörper noch Paginierung oder Filterparameter. Er gibt die gespeicherten Profile des zugehörigen Kontos zurück; gehen Sie nicht von einer bestimmten Reihenfolge aus. Vermeiden Sie bei großen Konten häufiges Abfragen der vollständigen Liste.

Liste in der Antwort

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

Wenn keine passenden aktiven Profile vorhanden sind, gibt der Handler den API-Code 200 und eine leere Antwortliste zurück. response[].id ist die UUID des lokalen Profils, die beim Erstellen als uuid zurückgegeben wird; es handelt sich nicht um eine Identitäts-ID oder Adress-ID.

Zurückgegebene Profilfelder

Die Feldauswahl enthält 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 und date_created.

Optionale Werte können je nach gespeicherten Daten leer sein oder null enthalten. Diese Feldauswahl des Altsystems enthält weder email noch Felder zur Länderauswahl, identity_id, address_id, Verweise auf hochgeladene Dateien, Nachweislisten oder den Verifizierungsstatus. Dieser Endpunkt dient nicht dazu, den Status von Nachweisen oder die Genehmigung einer Registrierung abzufragen. Behandeln Sie die zurückgegebenen Identitäts-, Kontakt- und Unterschriftsdaten vertraulich.

Nächste Schritte

Speichern Sie die Entitäts-IDs aus der ursprünglichen Antwort von create_document für spätere Anhänge. Falls diese Antwort verloren gegangen ist, lassen sich die IDs mithilfe dieser Liste nicht wiederherstellen. Sehen Sie sich das Profil im Portal an oder wenden Sie sich an den Support, statt automatisch ein Duplikat anzulegen.