---
title: "List all Subscriptions"
method: GET
path: "/subscriptions"
tags: ["Webhook Subscriptions"]
---

# List all Subscriptions

`GET /subscriptions`

## Request

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

This operation returns a list of subscriptions.

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

## Query parameters

- `page` integer
- `per_page` 10 | 20 | 50 | 100

## Response `200`

Successful response example

- object
  - `subscriptions` Subscription[], required
    - `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.
  - `current_page` integer, required: The current page number
  - `last_page` integer, required: The last page number
  - `per_page` 10 | 20 | 50 | 100, required: The number of items per page (allowed values: 10, 20, 50, 100)
  - `total` integer, required: The total number of items

## Other responses

- `422`: Bad request (validation error) response for invalid page size

---

[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)