---
title: "POST /api/certified-materials/requests"
method: POST
path: "/api/certified-materials/requests"
tags: ["CertifiedMaterials/Requests"]
---

# POST /api/certified-materials/requests

`POST /api/certified-materials/requests`

Create one or more evidence requests, linking orders and documents and notifying the supplier.

## Request body

- union
  - object
    - `type` 'document_submission' | 'document_revision'
    - `supplierCompanyId` string
    - `supplierAssigneeUserIds` string[]
    - `requestedDocTypes` string[]
    - `message` string
    - `orders` object[]
      - `orderId` string, uuid, required
      - `dueDate` string, nullable
    - `orderIds` string[]
    - `documentIds` string[]
  - object[]
    - `type` 'document_submission' | 'document_revision'
    - `supplierCompanyId` string
    - `supplierAssigneeUserIds` string[]
    - `requestedDocTypes` string[]
    - `message` string
    - `orders` object[]
      - `orderId` string, uuid, required
      - `dueDate` string, nullable
    - `orderIds` string[]
    - `documentIds` string[]

## Response `201`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` union, required
    - object
      - `id` string, required
      - `companyId` string, nullable, required
      - `requestedByCompanyName` string, nullable, required
      - `supplierCompanyId` string, nullable, required
      - `status` 'pending' | 'partial' | 'completed' | 'cancelled', required
      - `type` 'document_submission' | 'document_revision', required
      - `requestedDocTypes` string[], required
      - `message` string, nullable, required
      - `dueDate` string, nullable, required
      - `createdBy` string, nullable, required
      - `lastReminderSentAt` string, nullable, required
      - `createdAt` string, required
      - `updatedAt` string, required
      - `orderIds` string[], required
      - `documentIds` string[], required
    - object
      - `created` object[], required
        - `id` string, required
        - `companyId` string, nullable, required
        - `requestedByCompanyName` string, nullable, required
        - `supplierCompanyId` string, nullable, required
        - `status` 'pending' | 'partial' | 'completed' | 'cancelled', required
        - `type` 'document_submission' | 'document_revision', required
        - `requestedDocTypes` string[], required
        - `message` string, nullable, required
        - `dueDate` string, nullable, required
        - `createdBy` string, nullable, required
        - `lastReminderSentAt` string, nullable, required
        - `createdAt` string, required
        - `updatedAt` string, required
        - `orderIds` string[], required
        - `documentIds` string[], required
      - `totalCreated` number, required

## Other responses

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

## Changes

> 46 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/requests/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/63e640ecf381?raw)