Skip to main content
POST
/
v1
/
matching
/
manual
Create a manual match
curl --request POST \
  --url https://matcher.sandbox.lerian.net/v1/matching/manual \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "transactionIds": [
    "019c96a0-10ce-75fc-a273-dc799079a99c"
  ],
  "notes": "Manual match for Q4 reconciliation"
}
'
{
  "matchGroup": {
    "confidence": {},
    "confirmedAt": "<string>",
    "contextId": "<string>",
    "createdAt": "<string>",
    "id": "<string>",
    "items": [
      {
        "allocatedAmount": 123,
        "allocatedCurrency": "<string>",
        "allowPartial": true,
        "createdAt": "<string>",
        "expectedAmount": 123,
        "id": "<string>",
        "matchGroupId": "<string>",
        "transactionId": "<string>",
        "updatedAt": "<string>"
      }
    ],
    "rejectedReason": "<string>",
    "ruleId": "<string>",
    "runId": "<string>",
    "status": "PROPOSED",
    "updatedAt": "<string>"
  }
}

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-Key
string

Optional idempotency key for safe retries. Also accepts Idempotency-Key as an alternative header name. If the same key is sent again and the original request was already processed, the cached response is returned with X-Idempotency-Replayed: true.

See Retries and idempotency for details.

Query Parameters

​
contextId
string
required

Context ID

Body

application/json

Manual match payload

​
transactionIds
string[]
required
Minimum array length: 2
Example:
["019c96a0-10ce-75fc-a273-dc799079a99c"]
​
notes
string
Example:

"Manual match for Q4 reconciliation"

Response

Indicates that the resource was successfully created.

The response includes the X-Idempotency-Replayed header.

If the value is false, the request was just processed. If the value is true, the response is a replay of a previously processed request.

See Retries and idempotency for more details.

​
matchGroup
object