Skip to main content
GET
/
v1
/
imports
/
contexts
/
{contextId}
/
transactions
/
search
Search transactions
curl --request GET \
  --url https://matcher.sandbox.lerian.net/v1/imports/contexts/{contextId}/transactions/search \
  --header 'Authorization: Bearer <token>'
{
  "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

Search results with offset pagination

Search results for transactions with offset pagination

​
items
object[]
​
total
integer<int64>

Total number of matching transactions

​
limit
integer

Maximum items per page

Example:

20

​
offset
integer

Number of items skipped

Example:

0