Skip to main content
GET
Retrieve a reconciliation exception

Authorizations

X-API-KEY
string
header
required

Path Parameters

id
string
required

Query Parameters

amount_min
integer

Include records with signed amount >= amount_min (cents)

amount_max
integer

Include records with signed amount <= amount_max (cents)

date_from
string<date>

Include records with transaction date >= date_from

date_to
string<date>

Include records with transaction date <= date_to

direction
enum<string>

Include only debits (amount < 0) or credits (amount > 0)

Available options:
debit,
credit
counterparty
string

Case-insensitive substring match on record description

age_bucket
enum<string>

Convenience age filter on time since overdue_at

Available options:
lt_7d,
7_30d,
30_90d,
gt_90d

Response

Exception retrieved

A reconciliation exception represents unmatched overdue records that need human attention. Exceptions are scoped to a (reconciliation, data_stream) tuple and managed by the sweeper job — record membership is computed on read from the set of unmatched records whose overdue_at has passed.

reconciliation_id
integer
required

The reconciliation this exception belongs to

data_stream_id
integer
required

The data stream this exception is scoped to

title
string
required
id
integer
reconciliation_name
string

Name of the parent reconciliation

data_stream_name
string

Human-readable name of the scoped data stream

data_stream_key
string

Immutable key of the scoped data stream

description
string
status
enum<string>
default:open
Available options:
open,
investigating,
dismissed,
resolved
created_at
string<date-time>
updated_at
string<date-time>
opened_at
string<date-time> | null

When the exception most recently transitioned into an open state. Distinct from created_at so reopening is tracked cleanly.

closed_at
string<date-time> | null

When the exception most recently transitioned into a resolved or dismissed state. Cleared on reopen.

assignees
object[]
decimal_places
integer
default:2

Number of decimal places (2 for USD)

aggregates
object

Whole-exception aggregates over the current unmatched overdue slice.

filtered_aggregates
object

Aggregates restricted to the filter query parameters. Equals aggregates when no filter is supplied. Only present on the show response.

comments
object[]

Comments on this exception, oldest first

investigation
object | null

The most recent agent investigation session for this exception, if any.

investigation_sessions
object[]

Up to the five most recent investigation sessions, newest first. Exceptions may accumulate multiple sessions as the overdue set evolves.