---
title: "GET /subscriptions/{id}/history"
method: GET
path: "/subscriptions/{id}/history"
tags: ["Subscriptions"]
---

# GET /subscriptions/{id}/history

`GET /subscriptions/{id}/history`

Retrieve a subscription's history

## Path parameters

- `id` integer, required

## Query parameters

- `created_at_min` string, date-time
- `created_at_max` string, date-time

## Response `200`

Successful operation. Response will return an array of 0 or more history entries

- SubscriptionHistoryService[]
  - `id` integer — The SamCart ID for the subscription history record
  - `subscription_id` integer — The SamCart ID for the subscription
  - `new_status` 'active' | 'canceled' | 'delinquent' | 'completed' | 'paused' | 'invalid_processor' | 'sca_required' | 'deleted' — The status of the subscription
  - `source` string — The source of the change
  - `type` string — The type of change
  - `change_date` string, date-time — The UTC date and time that the change was made

## Other responses

- `404` — Subscription could not be found

---

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