---
title: "Find suppliers by their IDs or references where at least one of the two parameters must be provided and maximum allowed is 100."
method: GET
path: "/public/v2/eudr/customers/suppliers"
tags: ["EUDR - Customers - Suppliers"]
---

# Find suppliers by their IDs or references where at least one of the two parameters must be provided and maximum allowed is 100.

`GET /public/v2/eudr/customers/suppliers`

Find suppliers by providing either a list of target IDs or a list of references. Exactly one of the two parameters must be provided. The maximum number of allowed IDs or references is limited to 100. Returns a list of supplier details for the provided identifiers, including screening status, references, connection contacts, and supplier maturity when available.

**Use Cases**:
- Look up suppliers by internal target IDs
- Resolve suppliers by external reference codes
- Retrieve supplier details for product or compliance workflows

**Required permission:** `access_public_products`

## Query parameters

- `targetIds` integer
- `refs` unknown[]
  - unknown

## Response `200`

List of suppliers matching the provided IDs or references.

- PublicEUDRSupplier[]
  - `id` integer, required — Supplier ID
  - `name` string, required — Supplier name
  - `location` string, nullable — Supplier location
  - `isPublic` boolean, required — Indicates if the supplier profile is public
  - `organization` PublicEUDROrganization — Organization information for a supplier. Contains organization ID, name, and location.
    - `id` integer, required — Organization ID
    - `name` string, required — Organization name
    - `location` string, nullable — Organization location
  - `screened` boolean, required — Indicates if the supplier has been screened or not
  - `references` PublicSupplierReference[], nullable — List of references associated with the supplier
    - `id` string, required — Reference ID
    - `source` string, nullable — Source of the reference
  - `connectionContacts` PublicSupplierConnectionContact[], nullable — List of connection contacts for the supplier
    - `id` integer, required — Unique identifier of the connection contact.
    - `email` string, email, nullable — Email address of the connection contact. May be null if not provided.
  - `supplierMaturity` PublicSupplierMaturity — Public API payload representing the status of a supplier maturity assessment
    - `answerStatus` 'Requested' | 'InProgress' | 'Good' | 'Critical', nullable — Enum representing possible statuses for a supplier's questionnaire answer in the public API.
    - `answerHidden` boolean, nullable — True if the answer is hidden due to permission status (e.g., denied or not requested), otherwise false.

## Other responses

- `400` — Invalid parameters: both or neither of targetIds and refs provided, or exceeded maximum allowed.
- `403` — 403 Forbidden - Authentication or authorization failure. This status code is returned when: (1) the request lacks valid authentication credentials (missing or invalid X-Auth-Token header), or (2) the authenticated user does not have the required permission to access this resource.
- `429` — 429 Too Many Requests - API rate limit exceeded. The request has been rejected because the rate limit for this endpoint has been exceeded. Default rate limits: GET requests - 100 per 10 seconds, 500 per minute; POST/PUT/PATCH/DELETE requests - 20 per 10 seconds, 100 per minute. For increased access, please contact customer success.
- `500` — 500 Internal Server Error - An unexpected error occurred on the server. The request may or may not have been processed.

---

[API](https://skmtc.net/prewave/apis/public-prewave-api.md) · [All operations](https://skmtc.net/prewave/apis/public-prewave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prewave/public-prewave-api/revisions/466169815b78/schema)