Count unmatched items

Use this endpoint to retrieve the total number of unmatched items for a specific context and date range.

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

Count unmatched items

cURL

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

200

Example

{ "count": 4250 }

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

unbounded · boolean · predeterminado: false

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

Respuesta

200

application/json

Unmatched count

count · integer<int64> · requerido

Total number of rows matching the query; clients use this to choose between a synchronous download (<1000 rows) and an asynchronous export job (>=1000 rows).

Ejemplo:

4250