Saltar al contenido principal
GET
/
v1
/
validations
Listar Validaciones de Transacciones
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": "Transaccion aprobada",
      "matchedRuleIds": [],
      "exceededLimitIds": [],
      "processingTimeMs": 23,
      "createdAt": "2026-01-30T10:30:00Z"
    }
  ],
  "hasMore": true,
  "nextCursor": "eyJpZCI6IjEyMzQifQ=="
}

Encabezados

​
Content-Type
string
requerido

El tipo de medio del recurso. Debe ser application/json.

​
X-API-Key
string
requerido

La clave API para autenticacion. Este encabezado es requerido para todos los endpoints excepto verificaciones de salud.

​
X-Request-Id
string<uuid>

Un identificador unico usado para rastrear y seguir cada solicitud.

Parámetros de consulta

​
limit
integer
predeterminado:100

El numero maximo de elementos a incluir en la respuesta. Predeterminado: 100, Maximo: 1000

Rango requerido: 1 <= x <= 1000
​
cursor
string

Cursor de paginacion de la respuesta anterior. Al usar cursor, sortBy y sortOrder no pueden ser cambiados.

​
sortBy
enum<string>
predeterminado:createdAt

El campo usado para ordenar los resultados.

Opciones disponibles:
createdAt,
processingTimeMs
​
sortOrder
enum<string>
predeterminado:DESC

El orden usado para ordenar los resultados.

Opciones disponibles:
ASC,
DESC
​
startDate
string<date-time>

Filtrar desde esta fecha (inclusivo). Debe estar en formato RFC3339 con zona horaria. Por defecto 90 dias antes de la hora actual.

​
endDate
string<date-time>

Filtrar hasta esta fecha (exclusivo). Debe estar en formato RFC3339 con zona horaria. Por defecto la hora actual.

​
decision
enum<string>

Filtrar por decision (ALLOW, DENY, REVIEW).

Opciones disponibles:
ALLOW,
DENY,
REVIEW
​
accountId
string<uuid>

Filtrar por ID de cuenta (UUID).

​
matchedRuleId
string<uuid>

Filtrar por ID de regla coincidente (UUID).

​
exceededLimitId
string<uuid>

Filtrar por ID de limite excedido (UUID).

​
segmentId
string<uuid>

Filtrar por ID de segmento (UUID).

​
portfolioId
string<uuid>

Filtrar por ID de portafolio (UUID).

​
transactionType
enum<string>

Filtrar por tipo de transaccion.

Opciones disponibles:
CARD,
WIRE,
PIX,
CRYPTO

Respuesta

Indica que la solicitud fue exitosa y la respuesta contiene los datos esperados.

Lista paginada de validaciones de transacciones.

​
transactionValidations
object[]

Lista de registros de validacion de transacciones.

​
hasMore
boolean

Si hay mas resultados disponibles.

​
nextCursor
string | null

Cursor para obtener la siguiente pagina. Null si no hay mas resultados.