Pular para o conteúdo principal
GET
/
v1
/
validations
Listar Validações de Transações
curl --request GET \
  --url https://tracer.lerian.io/v1/validations \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>'
{
  "transactionValidations": [
    {
      "validationId": "aa0e8400-e29b-41d4-a716-446655440001",
      "accountId": "bb0e8400-e29b-41d4-a716-446655440002",
      "segmentId": "cc0e8400-e29b-41d4-a716-446655440003",
      "transactionType": "CARD",
      "amount": 150000,
      "currency": "BRL",
      "decision": "ALLOW",
      "reason": "Transaction approved",
      "matchedRuleIds": [],
      "exceededLimitIds": [],
      "processingTimeMs": 23,
      "createdAt": "2026-01-30T10:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjEyMzQifQ=="
}

Cabeçalhos

​
Content-Type
string
obrigatório

O tipo de mídia do recurso. Deve ser application/json.

​
X-API-Key
string
obrigatório

A chave de API para autenticação. Este header é obrigatório para todos os endpoints, exceto verificações de integridade.

​
X-Request-Id
string<uuid>

Um identificador único usado para rastrear cada requisição.

Parâmetros de consulta

​
limit
integer
padrão:100

The maximum number of items to include in the response. Default: 100, Max: 1000

Intervalo obrigatório: 1 <= x <= 1000
​
cursor
string

Cursor de paginação da resposta anterior. Ao usar cursor, sortBy e sortOrder não podem ser alterados.

​
sortBy
enum<string>
padrão:createdAt

O campo usado para ordenar os resultados.

Opções disponíveis:
createdAt,
processingTimeMs
​
sortOrder
enum<string>
padrão:DESC

A ordem usada para ordenar os resultados.

Opções disponíveis:
ASC,
DESC
​
startDate
string<date-time>

Filtrar a partir desta data (inclusivo). Deve estar no formato RFC3339 com fuso horário. O padrão é 90 dias antes do horário atual.

​
endDate
string<date-time>

Filtrar até esta data (exclusivo). Deve estar no formato RFC3339 com fuso horário. O padrão é o horário atual.

​
decision
enum<string>

Filtrar por decisão (ALLOW, DENY, REVIEW).

Opções disponíveis:
ALLOW,
DENY,
REVIEW
​
accountId
string<uuid>

Filtrar por ID da conta (UUID).

​
matchedRuleId
string<uuid>

Filtrar por ID da regra correspondente (UUID).

​
exceededLimitId
string<uuid>

Filtrar por ID do limite excedido (UUID).

​
segmentId
string<uuid>

Filtrar por ID do segmento (UUID).

​
portfolioId
string<uuid>

Filtrar por ID do portfólio (UUID).

​
transactionType
enum<string>

Filtrar por tipo de transação.

Opções disponíveis:
CARD,
WIRE,
PIX,
CRYPTO

Resposta

Indica que a requisição foi bem-sucedida e a resposta contém os dados esperados.

Lista paginada de validações de transações.

​
transactionValidations
object[]

Lista de registros de validação de transações.

​
hasMore
boolean

Se há mais resultados disponíveis.

​
nextCursor
string | null

Cursor para buscar a próxima página. Nulo se não houver mais resultados.