PRprewave
Scores - Externals

Get external score history for one supplier

Returns score history per event type for one supplier. Identify the supplier using query parameters such as supplier ID, customer ID, own site ID, or Prewave ID — the same identifiers you use elsewhere in the public supplier APIs.

When to use this

  • Auditing what scores are stored for one supplier after an integration run.
  • Showing score history in a customer-facing report or internal dashboard.
  • Verifying that an upload landed as expected for a given supplier.

Optional filters

  • perspectiveId — limit results to a specific perspective (defaults to your account’s default).
  • groupId — narrow results to a score group when needed.

If something goes wrong

  • 400 — No supplier identifier was provided, or more than one supplier matched. Add or refine identifiers (for example include source).
  • 404 — No supplier matched the identifiers you sent.

Required permission: access_public_internal_score

get/public/v1/scores/externals

Request

Query parameters

supplierIdstring

Supplier ID of the target. Can be combined with customerId, ownId, and/or prewaveId.

Example:SAP-12345
customerIdstring

Customer ID of the target. Can be combined with supplierId, ownId, and/or prewaveId.

Example:CRM-67890
ownIdstring

Own site ID of the target. Can be combined with supplierId, customerId, and/or prewaveId.

Example:OWN-SITE-01
prewaveIdinteger

Prewave ID of the target. Can be combined with supplierId, customerId, and/or ownId.

Example:102006215
sourcestring

Optional source system to filter by. Applies to supplierId, customerId, and ownId (not prewaveId).

Example:SAP
perspectiveIdinteger

Optional. Perspective to filter scores by. If omitted, your account default is used.

groupIdinteger

Optional. Score group to filter results by.

Response

Score history for the supplier that matched your identifiers.

Example response

{
  "identifier": {
    "supplierId": "SAP-12345",
    "customerId": "CRM-67890",
    "ownId": "OWN-SITE-01",
    "prewaveId": 102006215,
    "source": "SAP"
  },
  "scores": [
    {
      "updatedAt": "2026-01-15T10:30:00Z",
      "validFrom": "2026-01-01T00:00:00Z",
      "validTo": "2026-12-31T23:59:59Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 26 revisions of this API.