---
title: "Get Subscription Information"
method: GET
path: "/subscriptions/{subscription}"
tags: ["Webhook Subscriptions"]
---

# Get Subscription Information

`GET /subscriptions/{subscription}`

## Request

- Base URL: `https://sandbox.signup.nmi.com/api/v1`
- URL: `https://sandbox.signup.nmi.com/api/v1/subscriptions/{subscription}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `/oauth/token` scopes: `subscriptions:read`

Returns information about a given subscription

**Required scope:** `subscriptions:read`

## Path parameters

- `subscription` string, required: The unique identifier of the subscription.

## Response `200`

Subscription information retrieved successfully

- Subscription: Subscription object.
  - `id` string, required: The unique identifier of the subscription.
  - `callback_url` string: The callback URL of the subscription.
  - `status` 'active' | 'inactive', required
  - `events` EventTypes[], required: Subscription events
  - `created_at` string, date-time, required: The date and time when the application was created.
  - `updated_at` string, date-time, required: The date and time when the application was last updated.

## Other responses

- `404`: Error response for resource not found

---

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