Select exception ids by filter

Resolves the ids of every exception matching the SAME filter as GET /v1/exceptions (status, severity, contextId, reason, assigned_to, external_system, search, date_from, date_to, min_age_days), up to a cap of 10000, for the bulk “select all matching” path. The response carries the filtered total and a truncated flag; the client chunks the returned ids into the capped bulk-action calls. No pagination/sort: it returns the whole filtered set (capped).

GET /v1/exceptions/ids

Select exception ids by filter

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/ids \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "ids": [
    "<string>"
  ],
  "total": 530,
  "truncated": false
}

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, PENDING_RESOLUTION, 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:

"[e-mail]"

external_system · string

Filter by external system

Ejemplo:

"JIRA"

search · string

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

200

application/json

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