---
title: "POST /api/certified-materials/ai/match/{documentId}"
method: POST
path: "/api/certified-materials/ai/match/{documentId}"
tags: ["CertifiedMaterials/AI"]
---

# POST /api/certified-materials/ai/match/{documentId}

`POST /api/certified-materials/ai/match/{documentId}`

Score a document's extracted data against candidate orders and record the suggestions.

## Path parameters

- `documentId` string, uuid, required

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `documentId` string, uuid, required
    - `candidates` object[], required
      - `orderId` string, uuid, required
      - `orderNumber` string, required
      - `articleNumber` string, nullable, required
      - `score` number, required
      - `matchedFields` string[], required
      - `reasoning` string, required
      - `matchedProduct` object
        - `order_number` string
        - `article_number` string
        - `quantity` number
        - `uom` string
      - `orderQuantity` number, nullable
    - `bestMatch` object, nullable, required
      - `orderId` string, uuid, required
      - `orderNumber` string, required
      - `articleNumber` string, nullable, required
      - `score` number, required
      - `matchedFields` string[], required
      - `reasoning` string, required
      - `matchedProduct` object
        - `order_number` string
        - `article_number` string
        - `quantity` number
        - `uom` string
      - `orderQuantity` number, nullable
    - `confidence` number, required
    - `quantityChecks` object[]
      - `article_number` string, required
      - `tc_quantity` number, required
      - `order_quantities_sum` number, required
      - `matched` boolean, required
      - `order_numbers` string[], required
      - `reasoning` string, required

## Other responses

- `400` — Default Response
- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

## Changes

> 34 revisions in range; 1 not diffed.

- **2026-09-11** `07beb74c037c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/certified-materials/ai/match/:documentId/post.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/retraced/apis/api-reference/revisions/329f5bd4d114?raw)