Skip to main content
POST
Create a manual match

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.

X-Idempotency
string

Optional idempotency key for safe retries. Matcher reads the key only from this header, and only when you send one. A request that carries a key only in X-Idempotency-Key or Idempotency-Key is refused with 400 (MTCH-0015), and nothing is processed. If the same key is sent again and the original request was already processed, the stored response is returned with X-Idempotency-Replayed: true. A malformed key returns 400, a key whose first request is still in progress returns 409, and an idempotency storage failure returns 500. These refusals are problem documents.

Query Parameters

contextId
string<uuid>
required

Context ID Context ID the transactions belong to

Body

application/json

Manual match payload

transactionIds
string[] | null
required

Transaction IDs to link (UUIDs)

Required array length: 2 - 50 elements
Example:
notes
string

Optional note for the manual match

Response

Indicates that the resource was successfully created.

matchGroup
object
required

The match group created by linking the supplied transactions