v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

Matching

List AI match-rule suggestions (the human-review queue)

Cursor-paginated list of rule suggestions for a context, optionally filtered by status (e.g. PENDING_REVIEW). Reads stored config-only candidates; egresses nothing. Tenant from the JWT, context from the path.

get/v1/matching/contexts/{contextId}/rule-suggestions

Path parameters

contextIdstring uuid required

Context ID

Query parameters

status'PENDING_REVIEW' | 'APPROVED' | 'REJECTED'

Filter by status

limitinteger

Page size

cursorstring

Opaque pagination cursor

Response

limitinteger required

Maximum number of items requested for this page

nextCursorstring

Opaque cursor for the next page; empty when there are no more results

prevCursorstring

Opaque cursor for the previous page; empty on the first page

Example response

{
  "items": [
    {
      "candidate": {
        "confidence": 0.82,
        "expectedImprovement": "+8% auto-match",
        "priority": 10,
        "rationale": "near-miss amounts cluster under 1%",
        "type": "TOLERANCE"
      },
      "contextId": "550e8400-e29b-41d4-a716-446655440000",
      "createdAt": "2026-06-16T10:30:00Z",
      "createdRuleId": "550e8400-e29b-41d4-a716-446655440000",
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "rejectReason": "too aggressive",
      "reviewerId": "user-42",
      "status": "PENDING_REVIEW",
      "updatedAt": "2026-06-16T10:35:00Z",
      "version": 1
    }
  ],
  "limit": 20,
  "nextCursor": "eyJpZCI6IjEyMyJ9",
  "prevCursor": "eyJpZCI6IjEyMiJ9"
}