---
title: "Retrieve a subscription"
method: GET
path: "/subscriptions/{id}"
tags: ["subscriptions"]
---

# Retrieve a subscription

`GET /subscriptions/{id}`

## Path parameters

- `id` string, required

## Response `200`

OK

- Subscription
  - `id` string, required
  - `platform_id` string, required
  - `subscriber_id` string, required
  - `mrr` string, required
  - `status` 'active' | 'canceled' | 'future' | 'paused' | 'trialing', required
  - `properties` SubscriptionPropertyValue[], required
    - `property` SubscriptionProperty, required
      - `id` string, required
      - `key` string, required
      - `name` string, required
      - `entity` 'subscription', required
      - `type` 'text' | 'number' | 'boolean' | 'date', required
      - `format` 'number' | 'currency', nullable, required
    - `value` union, required
      - string
      - string, date
      - number
      - boolean
    - `formatted_value` string, required
  - `data` object, required — Additional data about the subscription from the connected subscription platform
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401` — Error
- `404` — Error

---

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