Skip to main content
Reports turn a reconciliation run into something you can act on: how much matched, what’s still open, and how much money is exposed. Operations teams use them to work the day’s queue. Finance and compliance use them to close the books and document outcomes.

​
Available reports

Each report answers a different question:
  • Reconciliation summary: Matched and unmatched counts and amounts for the date range.
  • Match detail report: A list of matched transactions with their match group, source, amount, currency, and date.
  • Unmatched report: A list of transactions that remain unmatched for follow-up.
  • Exception report: A list of exceptions created in the date range, with severity, status, reason, and due date.
  • Variance report: Expected and actual fee totals per source, fee schedule, and currency, with the net variance and its percentage.
Each variance row also carries adjustmentsApplied, the signed sum of the adjustments recorded against it, and outstandingVariance, the variance that remains after them. Each variance page carries unattributedAdjustments: per-currency totals of the adjustments that no single row includes. Use the reporting dashboard endpoints to access reconciliation metrics and export data.
API Reference:

​
Dashboard analytics

The reporting dashboard provides reconciliation metrics for a context and date range. Reporting endpoints default to the 30-day window ending tomorrow (UTC) and normally limit the window to 90 days. Only the unmatched list and count endpoints accept unbounded=true to query without date bounds.

​
Dashboard aggregates

Use the combined dashboard aggregates endpoint for a single call that returns volume, match-rate, and SLA statistics for a context:
cURL
GET /v1/reports/contexts/{contextId}/dashboard accepts date_from, date_to, and an optional source_id filter, and returns a DashboardAggregatesResponse: More granular dashboard slices are available under /v1/reports/contexts/{contextId}/dashboard/* (for example metrics, match-rate, sla, volume, source-breakdown, and cash-impact).
There is no bare GET /v1/reports/contexts/{contextId} endpoint. The typed sub-paths under /v1/reports/contexts/{contextId}/... carry report data, for example dashboard, summary, matched, unmatched, and variance (all except dashboard have an /export variant, as does exceptions).
API Reference: Get dashboard aggregates

​
Source breakdown

View reconciliation performance by source, including match rates, transaction counts, and unmatched amounts:
cURL
API Reference: Get source breakdown

​
Cash impact

Assess the total financial exposure from unmatched transactions, broken down by currency and age:
cURL
The response includes byCurrency and byAge breakdowns to help prioritize resolution efforts.
API Reference: Get cash impact

​
Pagination

The matched, unmatched, and variance report endpoints use cursor-based pagination. Pass the cursor value from a previous response to retrieve the next page of results. If you provide an invalid cursor value, the API returns a 400 Bad Request error with a message indicating the pagination parameters are invalid.

​
Exports

The summary, matched, unmatched, variance, and exceptions reports each have a synchronous /export operation that returns the file in the response. Choose the format with format=csv (the default) or format=pdf. A CSV export holds at most 100,000 records, and a PDF export holds at most 25,000.
cURL
The matched, unmatched, variance, and exceptions reports also run as asynchronous export jobs, with a window of up to 365 days and CSV, JSON, or XML files. See Exports & disputes.

​
Quick counts

Use count endpoints for lightweight status checks without fetching full result sets:
cURL
Each count endpoint returns a single count value, ideal for lightweight dashboards or health checks that don’t need the full result set.

​
Best practices

Automate a daily summary report delivered each morning to keep stakeholders aligned.
Store reports in secure, durable storage. Financial artifacts often require multi-year retention.
Generate targeted reports by date and source. Avoid exporting everything by default.
Large reports can fail or stall. Export jobs use QUEUED, RUNNING, SUCCEEDED, FAILED, EXPIRED, and CANCELED. Alert on FAILED or prolonged RUNNING.

​
Next steps

Contexts and Sources

Set up reconciliation contexts and data sources.

Security

Learn how access control and data protection work in Matcher.