Saltar al contenido principal
GET
/
v1
/
exceptions
/
ids
Seleccionar ids de excepción por filtro
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/ids \
  --header 'Authorization: Bearer <token>'
{
  "ids": [
    "<string>"
  ],
  "total": 123,
  "truncated": true
}

Autorizaciones

Authorization
string
header
requerido

Autenticación con token Bearer (formato: "Bearer {token}")

Parámetros de consulta

contextId
string<uuid>

Filter by reconciliation context ID (UUID, verified against the tenant; 404 when unknown) Filtrar por ID de contexto de reconciliación (UUID, verificado contra el tenant; 404 cuando es desconocido)

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

status
enum<string>

Filter by status Filtrar por estado

Opciones disponibles:
OPEN,
ASSIGNED,
RESOLVED
severity
enum<string>

Filter by severity Filtrar por severidad

Opciones disponibles:
LOW,
MEDIUM,
HIGH,
CRITICAL
reason
enum<string>

Filter by exception reason Filtrar por motivo de excepción

Opciones disponibles:
UNMATCHED,
FX_RATE_UNAVAILABLE,
MISSING_BASE_AMOUNT,
MISSING_BASE_CURRENCY,
SPLIT_INCOMPLETE,
VALIDATION_FAILED,
SOURCE_MISMATCH,
DUPLICATE_TRANSACTION,
FEE_VARIANCE,
FEE_DATA_MISSING,
FEE_CURRENCY_MISMATCH,
FX_RATE_VARIANCE,
AGED_BREAK,
OVER_SETTLED
assigned_to
string

Filter by assigned user Filtrar por usuario asignado

Ejemplo:

"user@example.com"

external_system
string

Filter by external system Filtrar por sistema externo

Ejemplo:

"JIRA"

Free-text search across transaction id, reason, and external issue id (case-insensitive substring match) Búsqueda de texto libre en id de transacción, motivo e id de incidencia externa (coincidencia de subcadena sin distinción de mayúsculas)

Ejemplo:

null

date_from
string

Filter from date, inclusive lower bound. Accepts an RFC 3339 timestamp or a bare date (YYYY-MM-DD); a bare date is taken at 00:00:00 UTC Filtrar desde fecha, límite inferior inclusivo. Acepta una marca de tiempo RFC 3339 o una fecha simple (YYYY-MM-DD); una fecha simple se toma a las 00:00:00 UTC

Ejemplo:

"2025-01-01T00:00:00Z"

date_to
string

Filter to date, inclusive upper bound. Accepts an RFC 3339 timestamp or a bare date (YYYY-MM-DD); a bare date covers the whole day through 23:59:59.999999999 UTC Filtrar hasta fecha, límite superior inclusivo. Acepta una marca de tiempo RFC 3339 o una fecha simple (YYYY-MM-DD); una fecha simple cubre todo el día hasta las 23:59:59.999999999 UTC

Ejemplo:

"2025-01-31T23:59:59Z"

min_age_days
integer<int64>

Filter to exceptions at least this many days old (by created_at). 0 (default) disables the filter. Filtrar a excepciones de al menos esta antigüedad en días (por created_at). 0 (predeterminado) desactiva el filtro.

Rango requerido: 0 <= x <= 3650
Ejemplo:

30

Respuesta

OK

ids
string[] | null
requerido

ids de excepción que coinciden con el filtro, ordenados de forma determinista (created_at DESC, id DESC), limitados a 10000

Maximum array length: 10000
total
integer<int64>
requerido

Total de excepciones que coinciden con el filtro (conjunto completo; puede exceder los ids devueltos)

Ejemplo:

530

truncated
boolean
requerido

Verdadero cuando el conjunto filtrado excede los ids devueltos (se alcanzó el tope); una sola pasada masiva no cubrirá cada coincidencia

Ejemplo:

false