Skip to main content
GET
Select exception ids by filter

Autorizaciones

Authorization
string
header
requerido

Bearer token authentication (format: "Bearer {token}")

Parámetros de consulta

contextId
string<uuid>

Filter by reconciliation context ID (UUID, verified against the tenant; 404 when unknown)

Ejemplo:

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

status
enum<string>

Filter by status

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

Filter by severity

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

Filter by exception reason

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

Ejemplo:

"user@example.com"

external_system
string

Filter by external system

Ejemplo:

"JIRA"

Free-text search across transaction id, reason, and external issue id (case-insensitive substring match)

Ejemplo:

"550e8400"

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

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

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.

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

30

Respuesta

OK

ids
string[] | null
requerido

Exception ids matching the filter, deterministically ordered (created_at DESC, id DESC), capped at 10000

Maximum array length: 10000
total
integer<int64>
requerido

Total exceptions matching the filter (full set; may exceed the returned ids)

Ejemplo:

530

truncated
boolean
requerido

True when the filtered set exceeds the returned ids (the cap was reached); a single bulk pass will not cover every match

Ejemplo:

false