Sign in
latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

Suppliers - Sites

Get pending suppliers

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

get/public/v2/suppliers/sites/pending

Query parameters

uuidstring uuid

Optional UUID to filter pending suppliers. When provided, only the pending supplier with the matching UUID will be returned.

Response

Successfully retrieved pending suppliers

uuidstring uuid required

Batch request target UUID

namestring nullable

Name of the supplier

countryCodestring nullable

ISO country code

citystring nullable

City

addressstring nullable

Address

statusstring required

Status of the batch request target

reasonstring nullable

Reason for the current status

Example response

[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "supplierId": {
      "id": "SUP-12345",
      "source": "SAP"
    },
    "name": "Acme Corporation",
    "countryCode": "AT",
    "city": "Vienna",
    "address": "123 Main St, Vienna, Austria",
    "status": "Pending",
    "reason": "Awaiting processing"
  }
]