from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.users.lookup(
identifiers=["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.users.lookup({
identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Users.Lookup(ctx, didit.UsersLookupRequest{
Identifiers: []string{"usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.UsersLookupRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.users().lookup(UsersLookupRequest.builder()
.identifiers(List.of("usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->users->lookup([
'identifiers' => ['usr_8842', 'maria.o@gmail.com', 'f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418', 'usr_7001'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.users.lookup(identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Users.LookupAsync(new UsersLookupRequest
{
Identifiers = new string[] { "usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001" },
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request POST \
--url https://verification.didit.me/v3/users/lookup/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
'API de Consulta de Usuários: Verifique uma Lista de IDs
Resolva até 20,000 IDs de fornecedor, IDs de usuário da Didit ou e-mails em uma chamada e receba esses usuários na ordem enviada.
from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.users.lookup(
identifiers=["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.users.lookup({
identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"],
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.Users.Lookup(ctx, didit.UsersLookupRequest{
Identifiers: []string{"usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"},
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.util.List;
import me.didit.Didit;
import me.didit.types.UsersLookupRequest;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.users().lookup(UsersLookupRequest.builder()
.identifiers(List.of("usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"))
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->users->lookup([
'identifiers' => ['usr_8842', 'maria.o@gmail.com', 'f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418', 'usr_7001'],
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.users.lookup(identifiers: ["usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001"])
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Users.LookupAsync(new UsersLookupRequest
{
Identifiers = new string[] { "usr_8842", "maria.o@gmail.com", "f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418", "usr_7001" },
});
Console.WriteLine(JsonSerializer.Serialize(result));curl --request POST \
--url https://verification.didit.me/v3/users/lookup/ \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
'Como funciona
- Consulte a lista.
POST /v3/users/lookup/com seus identificadores. A chamada apenas lê e responde com umlookup_id, as contagens e os identificadores que não correspondem a nenhum usuário. - Leia os usuários. Passe o
lookup_idcomolookuppara Listar usuários. Ela retorna somente os usuários correspondentes, na ordem em que você enviou os identificadores.
Regras de correspondência
Cada identificador é comparado dentro da sua aplicação, nesta ordem:| Ordem | Comparado com | Regra |
|---|---|---|
| 1 | vendor_data | Correspondência exata |
| 2 | ID de usuário do Didit | Um UUID, o didit_internal_id do usuário |
| 3 | E-mail verificado | Não diferencia maiúsculas de minúsculas. Um e-mail pode corresponder a vários usuários, e todos eles são contados |
- As entradas em branco são descartadas, e as duplicatas são removidas, mantendo a primeira ocorrência.
- Uma requisição envia no máximo 100.000 entradas. Depois que as entradas em branco e as duplicatas são removidas, devem restar de 1 a 20.000 identificadores. Se qualquer um dos limites for excedido, a resposta é
400comcode: too_many_identifiers. - A busca considera somente a sua aplicação.
Requisição
{
"identifiers": [
"usr_8842",
"maria.o@gmail.com",
"f4e5e1f2-94a9-4f86-8c16-2b7d9b4db418",
"usr_7001"
]
}
Response
{
"lookup_id": "b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11",
"requested": 4,
"found": 3,
"not_found": [{ "identifier": "usr_7001", "position": 4 }],
"expires_at": "2026-11-19T10:30:00Z"
}
| Campo | Descrição |
|---|---|
lookup_id | Passe-o como lookup em Listar usuários. |
requested | Identificadores lidos, após a remoção de entradas em branco e duplicadas. |
found | Identificadores que corresponderam a pelo menos um usuário. |
not_found | Os identificadores que não corresponderam a nenhum usuário, cada um com sua position começando em 1 na lista enviada, após a remoção de duplicatas, para que você possa corrigir a lista na origem. |
expires_at | Quando o resultado expira. |
Leia os usuários correspondentes
curl -X GET 'https://verification.didit.me/v3/users/?lookup=b3a6f0c2-6a2e-4c0a-9d0e-5f3c1d2a7e11&limit=200' \
-H 'x-api-key: YOUR_API_KEY'
- Os usuários são retornados na ordem do identificador na sua lista, paginados com
limiteoffset. Quando um e-mail corresponde a vários usuários, eles são listados começando pela conta mais antiga. - O resultado é mantido por 24 horas, apenas para a sua aplicação. Depois disso,
lookupretorna404comcode: lookup_not_found: envie a lista novamente.
Recuperar uma consulta
GET /v3/users/lookup/{lookup_id}/ retorna o mesmo corpo da consulta, além de identifiers: a lista que você enviou, depois de remover os valores em branco e os duplicados, na mesma ordem.
Retorna 404 com code: lookup_not_found quando a consulta expirou, não existe ou pertence a outra aplicação.
Errors
| Status | Significado |
|---|---|
400 | Erro de validação: too_many_identifiers para mais de 100.000 entradas enviadas ou mais de 20.000 identificadores após a limpeza, ou {"identifiers": ["Add at least one identifier."]} para uma lista vazia. |
401 | x-api-key ausente ou inválido. |
403 | A chave não pode consultar usuários desta aplicação. |
404 | lookup_not_found: a consulta expirou, não existe ou pertence a outra aplicação. |
429 | Limite de requisições excedido. Respeite o Retry-After. |
Permissions
A chave de API precisa de acesso de leitura a usuários, e o endpoint nunca altera dados. Uma chave sem esse acesso, ou uma chave revogada, recebe403.
Os escopos são definidos individualmente para cada chave em chaves de API; as funções e permissões do Console determinam o que uma pessoa pode fazer no Console e não são avaliadas no tráfego da API.
No Console, Consultar uma lista precisa apenas da permissão para ler usuários.
Relacionados
Autorizações
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.
Corpo
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.
100000["usr_8842", "maria.o@gmail.com"]
Resposta
The lookup was read. Use lookup_id with List users.