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

# Get pending suppliers

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

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