# Get subscription

Gets a specific subscription details by ID.

Endpoint: GET /projects/{project_id}/subscriptions/{subscription_id}
Version: 2.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    Project ID.

  - `subscription_id` (integer, required)
    Subscription ID.

## Response 200 fields (application/json):

  - `id` (integer)
    Subscription ID

  - `plan` (object)

  - `plan.project_id` (integer)
    Project ID.

  - `plan.name` (object)
    Plan name. Value consists of pairs "localization":"plan name".

  - `plan.name.en` (string)
    English.

  - `plan.name.ru` (string)
    Russian.

  - `plan.name.cs` (string)
    Czech.

  - `plan.name.ar` (string)
    Arabic.

  - `plan.name.bg` (string)
    Bulgarian.

  - `plan.name.cn` (string)
    Chinese (Simplified).

  - `plan.name.tw` (string)
    Chinese (Traditional).

  - `plan.name.fr` (string)
    French.

  - `plan.name.de` (string)
    German.

  - `plan.name.he` (string)
    Hebrew.

  - `plan.name.it` (string)
    Italian.

  - `plan.name.ko` (string)
    Korean.

  - `plan.name.pl` (string)
    Polish.

  - `plan.name.pt` (string)
    Portuguese.

  - `plan.name.ro` (string)
    Romanian.

  - `plan.name.es` (string)
    Spanish.

  - `plan.name.th` (string)
    Thai.

  - `plan.name.tr` (string)
    Turkish.

  - `plan.name.vi` (string)
    Vietnamese.

  - `plan.name.ja` (string)
    Japanese.

  - `plan.charge` (object)
    Billing details.

  - `plan.charge.period` (object, required)
    Billing period.

  - `plan.charge.period.value` (integer, required)
    Number of time units. The value depends on the type parameter and can be: - from 1 to 366, if type is day - from 1 to 12, if type is month - 0 if type is lifetime

  - `plan.charge.period.type` (string, required)
    Time unit. Can be day, month or lifetime.
    Enum: "day", "month", "lifetime"

  - `plan.charge.amount` (number)
    Billing amount.

  - `plan.charge.currency` (string)
    Currency of the purchase. Three-letter currency code per [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `plan.charge.prices` (array)
    List of prices in different currencies.

  - `plan.charge.prices.setup_fee` (number)
    One-time setup fee charged as part of the first invoice.

  - `plan.id` (integer)
    Subscription plan ID.

  - `plan.external_id` (string)
    Plan external ID (32 characters).

  - `plan.description` (object)
    Plan description. Value consists of pairs "localization":"plan description".

  - `plan.group_id` (string,null)
    Group ID the plan is linked to.

  - `plan.expiration` (object)
    Subscription expiration details.

  - `plan.expiration.value` (integer,null, required)
    Validity time.

  - `plan.expiration.type` (string, required)
    Time unit. Can be day or month.
    Enum: "day", "month"

  - `plan.trial` (object)
    Trial period details.

  - `plan.trial.value` (integer, required)
    Number of time units.

  - `plan.trial.type` (string, required)
    Time unit. Can be day.
    Enum: "day"

  - `plan.grace_period` (object)
    Grace period details.

  - `plan.billing_retry` (object)
    Billing retry details.

  - `plan.billing_retry.value` (integer, required)
    Number of billing retries.

  - `plan.refund_period` (integer,null)
    Period of time that user can refund the payment for a subscription plan (in days).

  - `plan.tags` (array)
    Plan tags.

  - `plan.status` (object)

  - `plan.status.value` (string)
    Subscription plan status.
    Enum: "active", "disabled"

  - `user` (object)

  - `user.id` (string)
    User ID

  - `user.name` (string)
    User name

  - `product` (object,null)

  - `product.id` (integer,null)
    Product ID the plans are linked to.

  - `product.name` (string)
    Product name.

  - `product.group_id` (string)
    Group ID the product is linked to.

  - `product.description` (object)
    Localized item descriptions.

  - `charge_amount` (number)
    Billing amount.

  - `currency` (string)
    Currency of the purchase. Three-letter currency code per ISO 4217.

  - `date_create` (string)
    Subscription creation date in the YYYY-MM-DD’T’HH:MM:SS format per [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `date_end` (string)
    Subscription end date in the YYYY-MM-DD’T’HH:MM:SS format per [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `date_last_charge` (string,null)
    Last subscription charge date in the YYYY-MM-DD’T’HH:MM:SS format per [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `date_next_charge` (string,null)
    Next subscription charge date in the YYYY-MM-DD’T’HH:MM:SS format per [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `status` (string)
    Status
    Enum: "new", "active", "canceled", "non_renewing", "freeze"

  - `comment` (string)
    Reason for changing subscription status