---
title: "Changes to Get paginated historical price data"
method: GET
path: "/v1/prices/historical"
---

# Changes to Get paginated historical price data

`GET /v1/prices/historical`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 17 revisions.

- **2026-10-20** `dc3f91f8926d`: 2 info
- **2026-10-20** `b987321524a8`: 1 breaking, 3 info
- **2026-10-11** `84bf31be62ff`: 5 warning

## Changes

- **2026-10-20** `dc3f91f8926d`: 2 info
  - added the optional property `data/prices/items/alias_of` to the response with the `200` status
  - added the optional property `data/prices/items/requested_code` to the response with the `200` status
- **2026-10-20** `b987321524a8`: 1 breaking, 3 info
  - the response property `data/prices/items/observed_at` became nullable for the status `200`
  - added the optional property `data/prices/items/benchmark` to the response with the `200` status
  - added the optional property `data/prices/items/contract_month` to the response with the `200` status
  - added the optional property `data/prices/items/ingested_at` to the response with the `200` status
- **2026-10-11** `84bf31be62ff`: 5 warning
  - added the new `current` enum value to the `data/prices/items/data_status` response property for the response status `200`
  - added the new `degraded` enum value to the `data/prices/items/data_status` response property for the response status `200`
  - added the new `delayed` enum value to the `data/prices/items/data_status` response property for the response status `200`
  - added the new `provisional` enum value to the `data/prices/items/data_status` response property for the response status `200`
  - added the new `stale` enum value to the `data/prices/items/data_status` response property for the response status `200`

---

[Operation](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/docs/v1/prices/historical/get.md) - [API](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1.md) - [Page](https://skmtc.dev/oilpriceapi/apis/oil-price-api-v1/changes/v1/prices/historical/get)