---
title: "Get subscription ARR history"
method: GET
path: "/v1/subscriptions/{id}/arr-history"
tags: ["Subscriptions"]
---

# Get subscription ARR history

`GET /v1/subscriptions/{id}/arr-history`

List the ARR evolutions for a subscription in reverse chronological order.

## Path parameters

- `id` string, required

## Query parameters

- `limit` number — Maximum number of items to return (1-100).
- `cursor` string — Opaque cursor returned in the previous response's `next_cursor`. Omit to fetch the first page.
- `occurred_at__gte` string, date-time — Return evolutions that occurred at or after this UTC date and time.
- `occurred_at__lte` string, date-time — Return evolutions that occurred at or before this UTC date and time.

## Response `200`

- CursorPaginatedArrHistoryEntry — unresolved $ref

## Other responses

- `404` — Subscription not found.

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)