---
title: "Run deterministic outcome matching"
method: POST
path: "/api/v1/spools/{id}/match"
---

# Run deterministic outcome matching

`POST /api/v1/spools/{id}/match`

## Request

- Base URL: `https://spoolis.com`
- URL: `https://spoolis.com/api/v1/spools/{id}/match`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Idempotently persisted match results

- object
  - `matches` OutcomeMatch[]
    - `claim_id` string, required
    - `fact_ids` string[], required
    - `rule_id` string, required
    - `rule_version` string, required
    - `outcome` 'matched' | 'unmatched' | 'uncertain' | 'duplicate', required
    - `explanation` string[], required
    - `tolerances_applied` object, required

## Other responses

- `400`: Machine-readable API error
- `401`: Machine-readable API error
- `403`: Machine-readable API error
- `404`: Machine-readable API error
- `409`: Machine-readable API error
- `413`: Machine-readable API error
- `422`: Machine-readable API error
- `429`: Machine-readable API error
- `500`: Machine-readable API error
- `503`: Machine-readable API error

---

[API](https://skmtc.dev/spoolis/apis/spoolis-public-api.md) · [All operations](https://skmtc.dev/spoolis/apis/spoolis-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/spoolis/apis/spoolis-public-api/revisions/e438bfc05c01?raw)