Request validation for a supplier

Request a validation (discovery) for an existing supplier site. Validation is the process of verifying and enriching a supplier's data. Both endpoints (POST and GET) require the ACCESS_PUBLIC_VALIDATION_REQUEST permission.

Request body shape (OpenAPI schema: PublicValidationRequestPayloadV2):

{
  "identifier": {
    "supplierId": null,
    "customerId": null,
    "ownId": null,
    "prewaveId": 102006215,
    "source": null
  }
}

identifier: At least one of supplierId, customerId, ownId, or prewaveId must be non-empty / non-null. Optional source applies to the string IDs only.
Exactly one supplier must match (same rules as DELETE /public/v2/suppliers/sites). If your criteria match zero suppliers, 404 is returned; if more than one, 400 with a multiple-suppliers error.

Preconditions (enforced with 4xx responses):

The target must be of type POI (not a site-group or freelancer).
The target must not already be at a fully-validated level (level 5, 2L, or 5L).
There must be no pending validation or screening request for this supplier.

Asynchronous Processing:

The endpoint returns 202 Accepted immediately with a requestId UUID.
Poll status with the same supplier identifiers you used in identifier, e.g. GET /public/v2/suppliers/sites/validation?prewaveId=... (see get validation status).

Required Permission: ACCESS_PUBLIC_VALIDATION_REQUEST

post/public/v2/suppliers/sites/validation

Request body

Example request

{
  "identifier": {
    "supplierId": "SAP-12345",
    "customerId": "CRM-67890",
    "ownId": "OWN-SITE-01",
    "prewaveId": 102006215,
    "source": "SAP"
  }
}

Response

Validation request accepted

requestIdstring uuid required

UUID of the validation request, used to track the status via the GET endpoint

messagestring required

Success message

Example response

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "Validation request submitted successfully"
}