Get a reconciliation source

Use this endpoint to retrieve the details of a specific reconciliation source by its identifier.

GET /v1/contexts/{contextId}/sources/{sourceId}

Get a reconciliation source

cURL

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

200

Example

{
  "config": {
    "blank_external_id": "REJECT",
    "camt053": {
      "date_basis": "booking",
      "external_id_source": "ntry_ref"
    },
    "dialect": {
      "date_style": "iso",
      "decimal_style": "dot",
      "delimiter": "comma",
      "encoding": "utf-8"
    },
    "duplicate_key": [
      "external_id"
    ],
    "duplicate_key_changed_at": "2023-11-07T05:31:56Z",
    "duplicate_policy": "FLAG_AS_EXCEPTION",
    "fail_on_error_rate_percent": 50
  },
  "contextId": "550e8400-e29b-41d4-a716-446655440000",
  "createdAt": "2025-01-15T10:30:00Z",
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Primary Bank Account",
  "side": "LEFT",
  "type": "BANK",
  "updatedAt": "2025-01-15T10:30:00Z",
  "archivedAt": "2025-01-15T10:30:00Z"
}

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

sourceId · string<uuid> · requerido

The unique identifier of the reconciliation source. Source ID

Respuesta

200

application/json

Successfully retrieved source

config · object · requerido

Source-specific configuration object. Cross-key rules the schema cannot express: a duplicate_key component this source's field map does not fill is refused, because a key over an always-empty field makes every row a duplicate of every other; a source bound to an aggregator connection (reserved key connection_config_name) cannot carry a duplicate_key of its own, and a config holding both is refused in either direction; and editing duplicate_key governs later imports only — rows already imported keep the key they were deduplicated under, so a duplicate straddling the change is knowingly not detected.

Show child attributes

contextId · string · requerido

Identifier of the context this source belongs to.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

createdAt · string · requerido

Creation timestamp in RFC 3339 format.

Ejemplo:

"2025-01-15T10:30:00Z"

id · string · requerido

Unique identifier of the source.

Ejemplo:

"550e8400-e29b-41d4-a716-446655440000"

name · string · requerido

Human-readable name of the source.

Ejemplo:

"Primary Bank Account"

side · enum<string> · requerido

Matching side this source feeds. LEFT and RIGHT are the two sides reconciled against each other.

Opciones disponibles: LEFT, RIGHT

Ejemplo:

"LEFT"

type · enum<string> · requerido

Origin of the source data. LEDGER is the internal ledger; BANK is a bank statement feed; GATEWAY is a payment gateway; CUSTOM is a bespoke feed; FETCHER is a discovery-engine pull.

Opciones disponibles: LEDGER, BANK, GATEWAY, CUSTOM, FETCHER

Ejemplo:

"BANK"

updatedAt · string · requerido

Last update timestamp in RFC 3339 format.

Ejemplo:

"2025-01-15T10:30:00Z"

archivedAt · string

RFC 3339 timestamp when the source was archived; absent when the source is live.

Ejemplo:

"2025-01-15T10:30:00Z"