Skip to main content
GET
/
v1
/
exceptions
/
ids
Select exception ids by filter
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/exceptions/ids \
  --header 'Authorization: Bearer <token>'
{
  "ids": [
    "<string>"
  ],
  "total": 123,
  "truncated": true
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
contextId
string<uuid>

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

Example:

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

​
status
enum<string>

Filter by status

Available options:
OPEN,
ASSIGNED,
RESOLVED
​
severity
enum<string>

Filter by severity

Available options:
LOW,
MEDIUM,
HIGH,
CRITICAL
​
reason
enum<string>

Filter by exception reason

Available options:
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

Example:

"user@example.com"

​
external_system
string

Filter by external system

Example:

"JIRA"

​
search
string

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

Example:

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

Example:

"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

Example:

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

Required range: 0 <= x <= 3650
Example:

30

Response

OK

​
ids
string[] | null
required

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

Maximum array length: 10000
​
total
integer<int64>
required

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

Example:

530

​
truncated
boolean
required

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

Example:

false