Sign in
latestOpenAPI 3.0.12026-08-20112309904.6 KB

466169815b78

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

Query parameters

supplierIdstring

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

Example:SAP-12345

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

customerIdstring

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

Example:CRM-67890

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

ownIdstring

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

Example:OWN-SITE-01

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

prewaveIdinteger

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

Example:102006215

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

sourcestring

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

Example:SAP

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

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"
    }
  ]
}