Développeurs

GET/v3/get_document/{uuid}

Consulter un profil d’enregistrement

Consulter un profil actif appartenant à votre compte à l’aide de l’UUID de son document local.

Sur cette page
  1. Consulter un profil enregistré
  2. Requête de consultation du profil
  3. Réponse contenant le profil
  4. Champs du profil renvoyés
  5. Profil introuvable et nouvelles tentatives

Consulter un profil enregistré

Récupérez le profil d’enregistrement local actif sélectionné par son UUID au sein de votre compte. Cette opération renvoie les mêmes champs de profil limités que documents ; elle n’actualise pas la vérification par l’opérateur et ne renvoie pas les justificatifs joints.

Requête de consultation du profil

Authentifiez-vous avec votre compte API MultiTEL activé et l’adresse IP autorisée pour ce compte. Les exemples utilisent des identifiants d’authentification HTTP Basic stockés dans des variables d’environnement. Vérifiez à la fois la réponse HTTP et le champ JSON status.code ; une réponse HTTP 200 ne suffit pas à confirmer la réussite de l’opération. Toutes les valeurs des exemples sont fictives.

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

Attribuez à DOCUMENT_UUID la valeur de response.uuid renvoyée par create_document, ou celle de response[].id renvoyée par documents. N’utilisez ici ni identity_id, ni address_id, ni un identifiant de justificatif, ni un numéro de téléphone. Aucun corps de requête n’est nécessaire.

Réponse contenant le profil

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

Champs du profil renvoyés

La projection contient 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 et date_created.

Les valeurs facultatives peuvent être vides ou valoir null selon les données enregistrées. Cette projection héritée omet email, les sélecteurs de pays, identity_id, address_id, les références aux fichiers téléversés, les listes de justificatifs et le statut de vérification. Ce point de terminaison ne sert ni à consulter le statut des justificatifs ni à déterminer l’approbation de l’enregistrement. Traitez les données d’identité, les coordonnées et les données de signature renvoyées comme des informations privées.

Profil introuvable et nouvelles tentatives

Le code API 404 accompagné du message Failed, Not found signifie qu’aucun profil actif correspondant à ce compte et à cet UUID n’a été trouvé. Vérifiez le compte, l’identifiant et si le profil a été supprimé. Cette recherche ne divulgue pas le profil d’un autre compte.

Une consultation réussie ne confirme ni l’acceptation des justificatifs ni l’activation du numéro. Si vous reprenez une opération après une requête de création ou de rattachement dont le résultat est incertain, examinez le document dans le portail avant d’envoyer une autre requête modifiant l’état des données.