---
title: "Get Price Timeseries Endpoint"
method: GET
path: "/v1/prices/{service_slug}/timeseries"
tags: ["prices"]
---

# Get Price Timeseries Endpoint

`GET /v1/prices/{service_slug}/timeseries`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/prices/{service_slug}/timeseries`
- Auth: none declared. Required headers: `X-API-Key`

Time-series formatted price history for graphing.

## Path parameters

- `service_slug` string, required: Service slug — get slugs from `GET /v1/services`

## Query parameters

- `country` string: ISO country code: AU, US, UK, CA, NZ
- `tier` string, nullable: Plan tier: basic, standard, premium (returned in service detail)
- `months` integer: Number of months of history to return

## Headers

- `X-API-Key` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)