Ein gespeichertes Profil abrufen
Rufen Sie das aktive lokale Registrierungsprofil innerhalb Ihres Kontos anhand seiner UUID ab. Dabei werden dieselben begrenzten Profilfelder zurückgegeben wie bei documents; die Verifizierung durch den Netzbetreiber wird dabei weder aktualisiert, noch werden angehängte Nachweise zurückgegeben.
Profilanfrage
Authentifizieren Sie sich mit Ihrem freigeschalteten MultiTEL-API-Konto über die dafür zugelassene IP-Adresse. Die Beispiele verwenden in Umgebungsvariablen gespeicherte Zugangsdaten für die HTTP-Basic-Authentifizierung. Prüfen Sie sowohl die HTTP-Antwort als auch das folgende JSON-Feld: status.code; eine HTTP-Antwort mit dem Status 200 allein bestätigt keinen Erfolg. Alle Beispielwerte sind frei erfunden.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_document/$DOCUMENT_UUID"Setzen Sie DOCUMENT_UUID auf den Wert von response.uuid aus create_document, oder auf den Wert von response[].id aus documents. Verwenden Sie hier weder identity_id noch address_id, eine Nachweis-ID oder eine Telefonnummer. Ein Anfragekörper ist nicht erforderlich.
Profilantwort
{
"status": {
"code": 200,
"msg": "Success"
},
"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"
}
}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 ältere Feldauswahl lässt email, Länderauswahlfelder, identity_id, address_id, Verweise auf hochgeladene Dateien, Nachweislisten und den Verifizierungsstatus aus. Dieser Endpunkt dient weder der Abfrage des Nachweisstatus noch der Genehmigung einer Registrierung. Behandeln Sie die zurückgegebenen Identitäts-, Kontakt- und Unterschriftsdaten als vertraulich.
Nicht gefunden und erneute Versuche
Der API-Code 404 mit der Meldung Failed, Not found bedeutet, dass für dieses Konto und diese UUID kein passendes aktives Profil gefunden wurde. Prüfen Sie das Konto, die Kennung und ob das Profil gelöscht wurde. Diese Abfrage gibt kein Profil eines anderen Kontos preis.
Ein erfolgreicher Abruf bestätigt weder die Annahme von Nachweisen noch die Aktivierung einer Rufnummer. Wenn Sie nach einer Anfrage zum Erstellen oder Anhängen mit unklarem Ergebnis fortfahren, prüfen Sie das Dokument im Portal, bevor Sie eine weitere zustandsändernde Anfrage senden.