---
title: "GET /api/certified-materials/users"
method: GET
path: "/api/certified-materials/users"
tags: ["CertifiedMaterials/Users"]
---

# GET /api/certified-materials/users

`GET /api/certified-materials/users`

List users, optionally filtered to a company the caller is linked to. A company the caller has no link to yields an empty page rather than an error. Accepts a live company id or a buyer-assigned internal company code.

## Query parameters

- `search` string
- `companyId` string
- `retracedCompanyId` string
- `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
    - `name` string, required
    - `email` string, nullable, required
    - `retracedCompanyId` string, nullable, required

## Other responses

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

## Changes

> 43 revisions in range; 1 not diffed.

- **2026-09-12** `329f5bd4d114` — 1 breaking
  - the response property `data/items/email` became nullable for the status `200`
- **2026-09-11** `07beb74c037c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/certified-materials/users/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/a8932a002646?raw)