---
title: "Get customer ARR history"
method: GET
path: "/v1/customers/{id}/arr-history"
tags: ["Customers"]
---

# Get customer ARR history

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

List the subscription-level ARR evolutions for a customer 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` — Customer 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)