---
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`

## Request

- Base URL: `https://api.prewave.com`
- URL: `https://api.prewave.com/public/v2/eudr/customers/suppliers`
- Auth: API key in header `X-Auth-Token`
- TypeScript: <https://skmtc.dev/prewave/apis/public-prewave-api/docs/public/v2/eudr/customers/suppliers/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/prewave/apis/public-prewave-api.md) - [All operations](https://skmtc.dev/prewave/apis/public-prewave-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prewave/apis/public-prewave-api/revisions/bd063a0703c0?raw)