---
title: "Get pending suppliers"
method: GET
path: "/public/v2/suppliers/sites/pending"
tags: ["Suppliers - Sites"]
---

# Get pending suppliers

`GET /public/v2/suppliers/sites/pending`

## Request

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

Retrieve all pending supplier creation requests for the authenticated user.

This endpoint returns supplier creation requests that are currently pending processing. These are suppliers that have been submitted via `POST /public/v2/suppliers/sites` (create supplier endpoint) but have not yet been processed and made available in the main suppliers list.

**Status Values:**
- `New`: The supplier creation request has been submitted and is awaiting initial processing
- `Pending`: The supplier creation request is being processed and is awaiting completion

Once processing is complete, suppliers will transition to a resolved state and become available via `GET /public/v2/suppliers/sites` (get all suppliers) or `GET /public/v2/suppliers/sites/find-by-identifier` (find by identifier). Pending suppliers are automatically removed from this endpoint once they are processed.

**Query Parameters:**
- `uuid` (optional): Filter results by the UUID of a specific pending supplier. When provided, only the pending supplier with the matching UUID will be returned. This is useful for tracking a specific supplier creation request returned from `POST /public/v2/suppliers/sites`.

**Response:**
Returns an array of pending supplier objects. Each entry includes the UUID (returned when creating a supplier), supplier ID information, supplier name, location details (countryCode, city, address), and status information. See the `PublicPendingSupplierV2DTO` schema for complete field definitions.

**Pagination:**
This endpoint returns all pending suppliers for the authenticated user without pagination.

**Required Permission**: `ACCESS_PUBLIC_SUPPLIERS`

## Query parameters

- `uuid` string, uuid

## Response `200`

Successfully retrieved pending suppliers

- PublicPendingSupplierV2DTO[]
  - `uuid` string, uuid, required: Batch request target UUID
  - `supplierId` PublicSupplierIdentifierId, required: Supplier ID identifying a supplier in an external system. Supplier IDs are identifiers from external systems (e.g., SAP, Coupa, DNB) that link suppliers to your organization's systems.
    - `id` string, required: The supplier ID identifier
    - `source` string, nullable: Source system of the supplier ID (e.g., 'SAP', 'Excel', 'Coupa'). Optional - omitted when null (legacy supplier IDs). Defaults to 'Public API' when creating suppliers via Public API v2.
  - `name` string, nullable: Name of the supplier
  - `countryCode` string, nullable: ISO country code
  - `city` string, nullable: City
  - `address` string, nullable: Address
  - `status` string, required: Status of the batch request target
  - `reason` string, nullable: Reason for the current status

## Other responses

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