QFind anything/

Trigger match

Matches an incoming transaction against expected candidates via LedgerMatch. Returns the full structure `{ matches, queryMetadata, hasMatches }`.

Parameters

incomingTransactionId(string)required

ID of the incoming transaction to match. Format: tran_inc_{abbreviation}_{16chars}.

POST/matches/match

curl -X POST "http://localhost:8000/api/v1/matches/match" \
  -H "X-Api-Key: $API_KEY" \
  -H "X-Tenant-Id: $TENANT_ID" \
  -H "X-Environment: production" \
  -H "Content-Type: application/json" \
  -d '{
    "incomingTransactionId": "tran_inc_acme_2Kp1GH0SLIjDWdEL"
  }'

Response(201)

{
  "matches": [
    {
      "id": "089fafeb-bfb2-491a-9fb3-718118e808be",
      "tenantId": "tenant_abc123",
      "environment": "production",
      "incomingTransactionId": "tran_inc_acme_2Kp1GH0SLIjDWdEL",
      "expectedTransactionId": "ext_abc123xyz",
      "ledgerMatchId": "lm_xyz789",
      "confidence": 0.95,
      "embeddingSimilarity": 0.92,
      "amountScore": 1,
      "dateScore": 0.85,
      "referenceMatch": false,
      "explanation": "Merchant and amount match",
      "matchedFields": {
        "merchant": true,
        "amount": true,
        "date": true,
        "description": false,
        "reference": false
      },
      "rank": 1,
      "status": "PENDING",
      "autoMatched": false,
      "acceptedAt": null,
      "rejectedAt": null,
      "acceptedBy": null,
      "rejectedBy": null,
      "rejectionReason": null,
      "createdAt": "2025-02-01T10:00:00.000Z",
      "updatedAt": "2025-02-01T10:00:00.000Z"
    }
  ],
  "queryMetadata": {
    "totalCandidates": 5,
    "filteredCandidates": 3,
    "processingTimeMs": 142
  },
  "hasMatches": true
}