Lister les profils d’enregistrement

Rechercher des profils d’enregistrement existants

Listez les profils d’enregistrement locaux actifs et non supprimés associés à votre compte API. Utilisez cette liste pour trouver l’UUID d’un profil avant de l’ouvrir avec get_document, et non pour déterminer si ses justificatifs ou l’enregistrement du numéro ont été approuvés.

Requête de liste

Authentifiez-vous avec votre compte API MultiTEL activé, depuis l’adresse IP autorisée pour ce compte. Les exemples utilisent des identifiants 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 à établir 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/documents

Ce gestionnaire ne prend en charge ni corps de requête, ni pagination, ni paramètres de filtrage. Il renvoie les profils stockés du compte correspondant ; ne supposez aucun ordre particulier. Pour les comptes volumineux, évitez de récupérer fréquemment la liste complète par interrogation périodique.

Liste renvoyée

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

En l’absence de profils actifs correspondants, le gestionnaire renvoie le code API 200 et une liste de réponse vide. response[].id est l’UUID du profil local renvoyé sous le nom uuid lors de la création ; ce n’est ni un identifiant d’identité ni un identifiant d’adresse.

Champs de 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 stockées. Cette projection héritée de l’ancienne version 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 permet de connaître ni le statut des justificatifs ni l’approbation de l’enregistrement. Traitez les données d’identité, de contact et de signature renvoyées comme des données privées.

Étapes suivantes

Conservez les identifiants d’entité figurant dans la réponse initiale de create_document pour les rattachements ultérieurs. Si cette réponse a été perdue, cette liste ne permet pas de récupérer ces identifiants. Consultez le profil dans le portail ou contactez l’assistance au lieu de créer automatiquement un doublon.