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

# GET /api/certified-materials/requests

`GET /api/certified-materials/requests`

List the caller's evidence requests. `status` accepts one value or a comma-separated list.

## Query parameters

- `type` 'document_submission' | 'document_revision'
- `status` union
  - 'pending' | 'partial' | 'completed' | 'cancelled'
  - string[]
- `supplierCompanyId` string
- `orderId` string, uuid
- `documentId` string, uuid
- `dueBefore` string, date-time
- `dueAfter` string, date-time
- `createdAfter` string, date-time
- `createdBefore` string, date-time
- `sortBy` 'dueDate' | 'createdAt' | 'updatedAt' | 'status'
- `sortOrder` 'asc' | 'desc'
- `page` integer
- `limit` integer

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
    - `pagination` object
      - `page` number, required — Current page number (1-based).
      - `limit` number, required — Page size used for this response. Endpoint defaults vary — see each endpoint's limit parameter.
      - `total` number, required — Total number of records across all pages.
      - `totalPages` number, required — Total number of pages. Iterate until page reaches totalPages.
  - `data` 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

## Other responses

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

## Changes

> 49 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/get.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/940ef021e2d5?raw)