---
title: "Search for supplier sites (max results: 100)"
method: GET
path: "/public/v2/eudr/customers/suppliers/search"
tags: ["EUDR - Customers - Suppliers"]
---

# Search for supplier sites (max results: 100)

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

## Request

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

Search for supplier sites by a free-text query. Only site-type suppliers are returned.
The query must be at least 3 characters long. The maximum number of results is limited to
100. If the query is too short or no matching supplier type
is found, an error is returned.

**Use Cases**:
- Search for suppliers by name or identifier
- Find supplier sites for product associations
- Discover available suppliers

**Required permission:** `access_public_products`

## Query parameters

- `query` string, required

## Response `200`

List of supplier sites matching the search criteria.

- PublicEUDRTarget[]
  - `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

## Other responses

- `400`: Query too short or invalid parameters.
- `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/d07712f25b17?raw)
