GET
/
consultas
/
logs
/
details
/
{id}
Detalhes de uma execução
curl --request GET \
  --url https://api.periciadecredito.com.br/consultas/logs/details/{id} \
  --header 'x-access-token: <api-key>'
{
  "id": 4201,
  "query_name": "kyc_pf",
  "query_id": 1,
  "user_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "attempt_number": 1,
  "status": "success",
  "response_time_ms": 843,
  "document": {
    "cpf": "12345678900"
  },
  "executed_at": "2026-04-10T14:32:00.000Z",
  "query_name_ref": "kyc_pf",
  "query_display_name": "KYC — Pessoa Física",
  "query_description": "Dados cadastrais, situação na Receita Federal e informações de contato de pessoas físicas.",
  "query_is_active": true,
  "user_id_ref": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "user": "integrador@empresa.com.br",
  "categorias": [
    "cadastral"
  ],
  "response": {
    "nome": "JOÃO DA SILVA",
    "cpf": "123.456.789-00",
    "situacao_receita": "REGULAR",
    "data_nascimento": "1985-03-22",
    "emails": [
      "joao@email.com"
    ],
    "telefones": [
      "(11) 98765-4321"
    ]
  }
}

​
Quando usar este endpoint

Use este endpoint em três cenários principais: 1. Recuperar o resultado completo de uma execução GET /consultas/logs devolve apenas metadados leves, sem o payload de resposta. Use GET /consultas/logs/details/{id} com o id retornado ali (ou o query_execution de uma execução completed) para obter o response completo. 2. Alternativa ao formato numérico de /consultas/resultado Recupera o mesmo payload que GET /consultas/resultado/{query_execution} (formato ID numérico), mas com metadados adicionais (categorias, status, tempo de resposta). Ambos respeitam o mesmo prazo de retenção do payload (90 dias) — a diferença é que, após expirar, este endpoint continua respondendo 200 com response: null, enquanto /consultas/resultado responde 410. 3. Auditoria e reprocessamento O campo document contém os parâmetros exatos que foram enviados na execução. Isso permite auditar qualquer execução passada e reproduzir os parâmetros se necessário.

​
Campos da resposta

CampoDescrição
idID permanente desta execução
query_name / query_name_refIdentificador interno da consulta
query_display_nameNome legível da consulta
query_descriptionDescrição da consulta
query_is_activeSe a consulta ainda está ativa hoje (pode ser false mesmo para uma execução passada bem-sucedida)
statussuccess ou error
response_time_msTempo total de execução em milissegundos
documentParâmetros que foram enviados (ex: { "cpf": "12345678900" })
categoriasSlugs das categorias da consulta (array de strings)
userE-mail/usuário do dono da execução
responseResposta completa do provedor — ver nota de permissão abaixo
executed_atData e hora da execução em UTC
Cada usuário só pode acessar seus próprios logs. Tentar acessar o log de outro usuário retorna 403 Forbidden.

​
O campo response pode não vir

Há duas situações distintas em que response não traz o payload esperado:
Se a conta não tem permissão para visualizar payloads brutos do provedor, o campo response é omitido inteiramente da resposta (não aparece, e não é null).
Se o prazo de retenção de 90 dias já passou, response vem null — mas o restante dos metadados (status, tempo de resposta, categorias) continua disponível normalmente.

Authorizations

​
x-access-token
string
header
required

Token JWT retornado pelo endpoint POST /auth/login. Inclua este header em todas as requisições autenticadas.

Path Parameters

​
id
string
required

ID do registro de execução (query_execution).

Response

Dados completos da execução, incluindo parâmetros enviados e resposta do provedor (quando permitido para a conta).

​
id
integer
Example:

4201

​
query_name
string
Example:

"kyc_pf"

​
query_id
integer
Example:

1

​
user_id
string
Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
attempt_number
integer
Example:

1

​
status
enum<string>
Available options:
success,
error
Example:

"success"

​
response_time_ms
integer
Example:

843

​
document
object

Parâmetros que foram enviados na execução

Example:
{ "cpf": "12345678900" }
​
executed_at
string<date-time>
Example:

"2026-04-10T14:32:00.000Z"

​
query_name_ref
string
Example:

"kyc_pf"

​
query_display_name
string
Example:

"KYC — Pessoa Física"

​
query_description
string
​
query_is_active
boolean
Example:

true

​
user_id_ref
string
​
user
string

E-mail/usuário do dono da execução

Example:

"integrador@empresa.com.br"

​
categorias
string[]

Slugs das categorias da consulta (base do tema visual usado em relatórios PDF)

Example:
["cadastral"]
​
response
object

Resposta completa retornada pelo provedor. Ausente por completo na resposta (não null) se a conta não tiver permissão para visualizar payloads brutos. null se o prazo de retenção do payload (90 dias) já expirou.

Example:
{
  "nome": "JOÃO DA SILVA",
  "cpf": "123.456.789-00",
  "situacao_receita": "REGULAR"
}