---
title: "Get Subscription"
method: GET
path: "/v5/subscriptions/{subscription_id}"
tags: ["Subscriptions"]
---

# Get Subscription

`GET /v5/subscriptions/{subscription_id}`

## Request

- Base URL: `https://sandbox.nmi.com/api`
- URL: `https://sandbox.nmi.com/api/v5/subscriptions/{subscription_id}`
- Auth: API key in header `Authorization`

Retrieve details for a specific subscription.

## Path parameters

- `subscription_id` integer, required

## Response `200`

Success

- SubscriptionResponse: Subscription response matching SubscriptionRestSerializer structure
  - `object` 'subscription', required: Resource type identifier
  - `id` string, required: Subscription ID
  - `created_date` string, date-time: Date the subscription was created, in UTC ISO 8601 format
  - `start_date` string, date-time, nullable: Subscription start date in UTC ISO 8601 format
  - `next_billing_date` string, date-time, nullable: Next billing date in UTC ISO 8601 format
  - `amount` string: Subscription amount
  - `customer_vault_id` string: Customer vault ID associated with the subscription
  - `delayed_condition` string: Delayed condition
  - `paused_subscription` 0 | 1: Whether the subscription is paused (0 = active, 1 = paused)
  - `plan` object, nullable: Associated plan
    - `id` string: Plan ID
    - `plan_name` string: Plan name
    - `plan_amount` string: Plan amount
    - `plan_payments` string: Number of payments (0 = until canceled)
    - `day_frequency` string: Day frequency (0 if not applicable)
    - `month_frequency` string: Month frequency (0 if not applicable)
    - `day_of_month` string: Day of month (empty if not applicable)

## Other responses

- `401`: Unauthorized
- `404`: Subscription not found

---

[API](https://skmtc.dev/nmi/apis/payments-api.md) - [All operations](https://skmtc.dev/nmi/apis/payments-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nmi/apis/payments-api/revisions/c03727f27e27?raw)