List unmatched transactions report

Use this endpoint to retrieve a paginated list of unmatched transactions for a specific context and date range. The response uses cursor-based pagination.

GET /v1/reports/contexts/{contextId}/unmatched

List unmatched transactions report

cURL

curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/reports/contexts/{contextId}/unmatched \
  --header 'Authorization: Bearer <token>'

200

Example

{
  "items": [
    {
      "amount": "1250.50",
      "currency": "USD",
      "date": "2025-01-15T10:30:00Z",
      "sourceId": "550e8400-e29b-41d4-a716-446655440002",
      "status": "PENDING",
      "transactionId": "550e8400-e29b-41d4-a716-446655440000",
      "dueAt": "2025-02-15T10:30:00Z",
      "exceptionId": "550e8400-e29b-41d4-a716-446655440003",
      "sourceName": "Acquirer Settlement File"
    }
  ],
  "pagination": {
    "next": "<string>",
    "prev": "<string>"
  }
}

Autorizaciones

Authorization · string · header · requerido

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

Encabezados

X-Request-Id · string

A unique identifier for tracing the request across services.

Parámetros de ruta

contextId · string<uuid> · requerido

The unique identifier of the reconciliation context. Context ID

Parámetros de consulta

date_from · string<date>

Start date (YYYY-MM-DD) Start date (YYYY-MM-DD), inclusive. Optional: defaults to 30 days before date_to. Window may not exceed 90 days unless unbounded=true.

date_to · string<date>

End date (YYYY-MM-DD) End date (YYYY-MM-DD), inclusive. Optional: defaults to tomorrow (UTC). Window may not exceed 90 days unless unbounded=true.

source_id · string<uuid>

Source ID filter

cursor · string

The cursor value for retrieving the next page of results. Cursor for pagination (opaque)

limit · integer<int64> · predeterminado: 20

The maximum number of items to include in the response. Maximum number of records to return

Rango requerido: 1 <= x <= 200

sort_order · enum<string> · predeterminado: desc

Sort order by date Sort order for created_at (asc or desc; defaults to desc)

Opciones disponibles: asc, desc

unbounded · boolean · predeterminado: false

When true, ignore date_from/date_to and the 90-day window cap to return the full unmatched backlog (still cursor-paged). Defaults to false (30-day default window, 90-day cap).

Respuesta

200

application/json

Paginated list of unmatched transactions

items · object[] | null · requerido

Unmatched transactions in the current page.

Show child attributes

pagination · object · requerido

Show child attributes