Skip to main content
GET
Select exception ids by filter

Autorizações

Authorization
string
header
obrigatório

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)

Exemplo:

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

status
enum<string>

Filter by status

Opções disponíveis:
OPEN,
ASSIGNED,
RESOLVED
severity
enum<string>

Filter by severity

Opções disponíveis:
LOW,
MEDIUM,
HIGH,
CRITICAL
reason
enum<string>

Filter by exception reason

Opções disponíveis:
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

Exemplo:

"user@example.com"

external_system
string

Filter by external system

Exemplo:

"JIRA"

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

Exemplo:

"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

Exemplo:

"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

Exemplo:

"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.

Intervalo obrigatório: 0 <= x <= 3650
Exemplo:

30

Resposta

OK

ids
string[] | null
obrigatório

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

Maximum array length: 10000
total
integer<int64>
obrigatório

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

Exemplo:

530

truncated
boolean
obrigatório

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

Exemplo:

false