Passer au contenu principal
POST
Python
L’API Look Up Users de Didit associe une liste pouvant contenir jusqu’à 20 000 identifiants aux utilisateurs de votre application en un seul appel, et vous indique les identifiants qui ne correspondent à aucun utilisateur. Utilisez-la lorsque vous disposez d’une liste de comptes, par exemple les bénéficiaires d’un lot de paiements, les comptes d’un partenaire ou les résultats d’une requête de détection de fraude, et que vous avez besoin du statut de vérification de chacun d’eux.

Fonctionnement

  1. Lancez la recherche. POST /v3/users/lookup/ avec vos identifiants. L’appel ne fait que lire les données et renvoie un lookup_id, les compteurs et les identifiants qui ne correspondent à aucun utilisateur.
  2. Consultez les utilisateurs. Transmettez le lookup_id comme lookup à Lister les utilisateurs. La requête ne renvoie que les utilisateurs correspondants, dans l’ordre où vous avez soumis les identifiants.

Règles de correspondance

Chaque identifiant est comparé au sein de votre application, dans l’ordre suivant :
  • Les entrées vides sont supprimées, et les doublons sont retirés en conservant la première occurrence.
  • Une requête envoie au plus 100,000 entrées. Une fois les entrées vides et les doublons supprimés, il doit rester entre 1 et 20,000 identifiants. Le dépassement de l’une ou l’autre limite renvoie 400 avec code: too_many_identifiers.
  • La recherche ne porte que sur votre application.

Requête

Réponse

Lire les utilisateurs correspondants

  • Les utilisateurs sont renvoyés dans l’ordre de leur identifiant dans votre liste, paginés avec limit et offset. Lorsqu’un même e-mail correspond à plusieurs utilisateurs, ils sont listés du compte le plus ancien au plus récent.
  • Le résultat est conservé pendant 24 heures, uniquement pour votre application. Passé ce délai, lookup renvoie 404 avec code: lookup_not_found : soumettez à nouveau la liste.

Récupérer une recherche

GET /v3/users/lookup/{lookup_id}/ renvoie le même corps que la recherche, avec en plus identifiers : la liste que vous avez soumise, après suppression des valeurs vides et des doublons, dans le même ordre. Elle renvoie 404 avec code: lookup_not_found lorsque la recherche a expiré, n’existe pas ou appartient à une autre application.

Erreurs

Autorisations

La clé API doit disposer de l’accès en lecture aux utilisateurs, et l’endpoint ne modifie jamais de données. Une clé qui ne dispose pas de cet accès, ou une clé révoquée, reçoit 403. Les scopes d’une clé sont définis pour chaque clé dans Clés API ; les rôles et autorisations de la Console déterminent ce qu’une personne peut faire dans la Console et ne sont pas évalués pour le trafic de l’API. Dans la Console, Rechercher une liste requiert uniquement l’autorisation de lire les utilisateurs.

Liens connexes

Autorisations

x-api-key
string
header
requis

Your application's API key, from Developers -> API keys in the Business Console. The primary key has full access. A named key can be scoped: none, read or write per resource, limited to some workflows or to approved sessions, to a list of IP addresses, and to an expiry date. 401 means the key is wrong, revoked or expired; 403 means no key was sent, the key has no access to this resource or action, or the request came from an address outside its IP list; 404 on a session route means the session is outside the key's workflows or statuses. A key without media access receives image, video and PDF URLs as null, and a key without sessions write receives session links and tokens as null. See https://docs.didit.me/console/api-keys.

Corps

application/json
identifiers
string[]
requis

Each entry is a vendor_data value, a Didit user ID or a verified email. Send at most 100,000 entries. Blank entries are dropped and duplicates removed, keeping the first, and at most 20,000 identifiers must remain. Either limit exceeded is a 400 with code: too_many_identifiers, and an empty list is a 400 too.

Maximum array length: 100000
Exemple:

Réponse

The lookup was read. Use lookup_id with List users.

lookup_id
string<uuid>
requis

Pass it as lookup to List users.

requested
integer
requis

Identifiers read, after blanks and duplicates were removed.

found
integer
requis

Identifiers that matched at least one user.

not_found
object[]
requis
expires_at
string<date-time>
requis

When the result expires (24 hours after the lookup).

Dernière modification le 20 novembre 2026