---
title: "POST /api/certified-materials/orders/{orderId}/field-match"
method: POST
path: "/api/certified-materials/orders/{orderId}/field-match"
tags: ["CertifiedMaterials/FieldMatching"]
---

# POST /api/certified-materials/orders/{orderId}/field-match

`POST /api/certified-materials/orders/{orderId}/field-match`

Re-run field matching for every document linked to an order and return the fresh results.

## Path parameters

- `orderId` string, uuid, required

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object[], required
    - `id` string, uuid, required
    - `documentId` string, uuid, required
    - `orderId` string, uuid, required
    - `documentType` 'tc' | 'invoice' | 'shipment' | 'po' | 'unknown' | 'fabric_certificate', required
    - `fileName` string, required
    - `status` 'pending' | 'valid' | 'warning' | 'error', required
    - `fields` object[], required
      - `field` string, required
      - `articleNumber` string, nullable
      - `key` string, required
      - `label` string, required
      - `status` 'valid' | 'needs_review' | 'error' | 'skipped', required
      - `expected` string, nullable
      - `actual` string, nullable
      - `source` 'order' | 'invoice' | 'packing_list' | 'self' | 'computed', required
      - `matchMethod` 'string' | 'ai'
      - `reasoning` string, nullable
      - `confidence` number, nullable
      - `coverageStatus` 'direct' | 'shared' | 'confirmed' | 'partial' | 'unallocated', nullable
      - `coveragePercentage` number, nullable
      - `coverageOrderCount` number, nullable
      - `isManuallyValidated` boolean, required
      - `validatedByUserName` string, nullable, required
      - `validatedAt` string, nullable, required
      - `requirementKey` string, nullable
    - `comments` string[], required
    - `matchScore` number, nullable, required
    - `matchedAt` string, nullable, 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/orders/:orderId/field-match/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)