Search transactions

Use this endpoint to search transactions within a reconciliation context. Supports free-text search, amount range filters, date filters, and status filters with offset-based pagination.

GET /v1/imports/contexts/{contextId}/transactions/search

Search transactions

cURL

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

200

{
  "items": [
    {
      "amount": "1000.50",
      "contextId": "019c96a0-10a0-72d2-9fb0-2b7de8093182",
      "createdAt": "2025-01-15T10:30:00.000Z",
      "currency": "BRL",
      "date": "2025-01-15T00:00:00.000Z",
      "description": "Wire transfer from ABC Corp",
      "externalId": "TXN-12345",
      "extractionStatus": "EXTRACTED",
      "id": "019c96a0-10ce-75fc-a273-dc799079a99c",
      "jobId": "019c96a0-10ce-75fc-a273-dc799079a99c",
      "sourceId": "019c96a0-108c-7a74-8e31-3789daffe1ed",
      "status": "PENDING"
    }
  ],
  "total": 123,
  "limit": 20,
  "offset": 0
}

Authorizations

Authorization · string · header · required

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

Headers

X-Request-Id · string

A unique identifier for tracing the request across services.

Path Parameters

contextId · string · required

The unique identifier of the reconciliation context.

Query Parameters

q · string

Free-text search query

amount_min · string

Minimum transaction amount

amount_max · string

Maximum transaction amount

date_from · string<date-time>

Start date filter (RFC 3339 format)

date_to · string<date-time>

End date filter (RFC 3339 format)

reference · string

Transaction reference (exact match)

currency · string

Currency code filter

source_id · string

Source ID filter

status · enum<string>

Transaction status filter

Available options: UNMATCHED, MATCHED, IGNORED, PENDING_REVIEW

limit · integer · default: 20

The maximum number of items to include in the response.

Required range: 1 <= x <= 50

offset · integer · default: 0

The number of items to skip before returning results.

Required range: x >= 0

Response

200

application/json

Search results with offset pagination

Search results for transactions with offset pagination

items · object[]

Show child attributes

total · integer<int64>

Total number of matching transactions

limit · integer

Maximum items per page

Example:

20

offset · integer

Number of items skipped

Example:

0