FurniOpsDocs
API referenceMatching

Retrieve a review pair

One pair: its variants, evidence, conflicts and the AI judge's answer.

  • Scopesproducts:read
  • Rate classread
GET/v1/match-pairs/{id}

One pair: its variants, evidence, conflicts and the AI judge's answer.

Authorization

apiKey
AuthorizationBearer <token>

An API key (fo_live_… / fo_test_…) as a bearer token

In: header

Path Parameters

id*string

Match pair (two variants matching offers for review) ID

Match^mpr_[0-9A-Za-z]{22}$

Header Parameters

FurniOps-Version?string

Dated API version; pinned per organisation on first use and overridable per request

Value in

  • "2026-10-01"
  • "2026-10-04"
FurniOps-Mode?string

The data the request acts on: test is the organisation's sandbox. An OAuth token picks it (live by default); an API key's mode is fixed, and naming the other one is refused

Value in

  • "live"
  • "test"
If-None-Match?string

ETag of a cached representation; a match returns 304

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/match-pairs/string"
{  "object": "match_pair",  "id": "string",  "status": "open",  "probability": 0,  "variants": [    {      "id": "string",      "product": "string"    },    {      "id": "string",      "product": "string"    }  ],  "evidence": [    {      "comparison": "string",      "level": -9007199254740991,      "weight": 0    }  ],  "conflicts": [    "string"  ],  "judgement": {    "object": "match_judgement",    "id": "string",    "model": "string",    "outcome": "merged",    "choice": "string",    "confidence": 0,    "reasons": [      {        "field": "string",        "subject_quote": "string",        "candidate_quote": "string"      }    ],    "note": "string",    "judged_at": "2019-08-24T14:15:22Z"  },  "merge": "string",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}

Retrieve the AI judge's settings GET

Whether the AI judge looks at the organisation's review pairs, its daily budget and how much of it was used, the confidence at which it merges, and the model it asks.

Retrieve a merge GET

One merge: the product groups and variants it joined, who decided it, and its undoing.