---
title: "Get Subscriptions"
method: GET
path: "/v1/players/{player_id}/subscriptions"
tags: ["Players' Subscriptions"]
---

# Get Subscriptions

`GET /v1/players/{player_id}/subscriptions`

Retrieve subscriptions for a player.

## Path parameters

- `player_id` string, required

## Query parameters

- `effective` boolean — Filter by effective status. True for effective only, False for non-effective only, None for all.
- `limit` integer — A limit on the number of objects to be returned
- `offset` integer — The number of objects to skip

## Response `200`

Successful Response

- AghanimS2sPlayerSubscriptionSchemasSubscriptionRead[]
  - `sku` string, required — Subscription unique SKU.
  - `id` string, required — Unique identifier for this subscription instance. Use this ID to track and manage the subscription throughout its lifecycle.
  - `name` string, required — Subscription display name.
  - `order_id` string, required — Order ID where the subscription was originally activated. Use this to correlate with order webhooks.
  - `status` 'trial' | 'active' | 'grace' | 'canceled' | 'locked' | 'ended' | 'expired' | 'paused' | 'pending', required — An enumeration.
  - `created_at` integer, required — Subscription creation date in Unix epoch time (seconds).
  - `updated_at` integer — Subscription last update date in Unix epoch time (seconds). Null if the subscription has not been updated.
  - `effective_until` integer — The date until which the subscription is effective in Unix epoch time (seconds) representing when the subscription benefits should remain accessible.
  - `metadata` object — Custom key-value pairs attached to the subscription. Null if no metadata is set.
  - `plan` Plan, required
    - `key` string, required — Plan unique key within subscription.
    - `name` string, required — Plan display name.
    - `offer` Offer
      - `key` string, required — Offer unique key.
      - `name` string — Offer display name.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.net/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aghanim/aghanim-server-to-server-api/versions/6402c25762c8/schema)