---
title: "Get subscription details"
method: GET
path: "/v3/subscriptions/{subscription_id}"
tags: ["Subscriptions"]
---

# Get subscription details

`GET /v3/subscriptions/{subscription_id}`

This endpoint retrieves the details of a specific subscription by ID.

## Path parameters

- `subscription_id` integer, required

## Headers

- `Content-Type` string, required
- `X-Date` string, date-time, required
- `X-Login` string, required
- `Authorization` string, required
- `X-Idempotency-Key` string

## Response `200`

Subscription details retrieved successfully

- Subscription
  - `id` integer, required — Unique identifier of the subscription.
  - `status` 'PENDING' | 'ACTIVE' | 'COMPLETED' | 'CANCELLED' | 'TERMINATED', required — Current status of the subscription.
  - `start_date` string, date, required — Date when the subscription started or will start.
  - `end_date` string, date — Date when the subscription ended or will end.
  - `last_renovation_date` string, date — Date of the last renovation.
  - `creation_date` string, date-time, required — Timestamp when the subscription was created.
  - `subscription_plan` 'DAILY' | 'WEEKLY' | 'MONTHLY' | 'ANNUALLY', required — Frequency plan of the subscription.
  - `plan_unit` integer, required — The number of units for the subscription plan.
  - `amount` number, double, required — Amount charged for the subscription.
  - `auto_renewal` boolean, required — Whether the subscription will automatically renew.
  - `last_modified_date` string, date-time — Timestamp when the subscription was last modified.
  - `renewals` integer, required — The number of times the subscription has been renewed.
  - `cancellation_date` string, date, nullable — The date the subscription was cancelled.
  - `currency` string, required — The currency of the subscription amount.
  - `last_charge_date` string, date — The date of the last charge attempt.
  - `payment_method` string — The payment method used for the subscription.
  - `invoice_id` string — The identifier for the invoice.
  - `error_url` string, uri — URL to redirect the user to in case of an error.
  - `success_url` string, uri — URL to redirect the user to upon successful payment.
  - `back_url` string, uri — URL to redirect the user back to your site.
  - `description` string — A brief description of the subscription.
  - `country` string, required — The two-letter country code (ISO 3166-1 alpha-2).
  - `deposits` Deposit[] — A list of all deposits that the subscription has generated.
    - `deposit_id` string, required — The unique identifier for the deposit.
    - `status` string, required — The status of the deposit.

## Other responses

- `420` — Subscription does not exist
- `500` — Generic Error

---

[API](https://skmtc.net/d24/apis/docs-d24-com.md) · [All operations](https://skmtc.net/d24/apis/docs-d24-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d24/docs-d24-com/versions/fb0e2ddec198/schema)