> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Vendor score history

> Historical Vouchmark Score data points for a monitored vendor.

Returns the score history for a vendor, showing how their Vouchmark Score changed at each event. Each point records the score before and after the change. Useful for trend analysis and audit trails.

## Path parameters

<ParamField path="vendorId" type="string" required>
  The monitored vendor's ID.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.vouchmark.com/v1/monitoring/vendors/cmp_aBcD.../score-history \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "vendorId": "cmp_aBcD...",
      "points": [
        {
          "eventId": "evt_aBcDeFgH...",
          "timestamp": "2026-05-11T18:42:00Z",
          "scoreBefore": 95,
          "scoreAfter": 90
        },
        {
          "eventId": "evt_iJkLmNoP...",
          "timestamp": "2026-04-27T09:00:00Z",
          "scoreBefore": null,
          "scoreAfter": 95
        }
      ]
    }
  }
  ```
</ResponseExample>

`scoreBefore` is `null` for the first recorded point. `timestamp` may be omitted on points where it is unknown.