---
title: "Retrieve a Subscription collection"
method: GET
path: "/subscriptions"
tags: ["Subscriptions"]
---

# Retrieve a Subscription collection

`GET /subscriptions`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

## Query parameters

- `customerId` string
- `billingMode` 'rbs_scheduled' | 'merchant_initiated'
- `status` 'created' | 'pending' | 'active' | 'delinquent' | 'suspended' | 'cancelled' | 'completed'
- `page` number
- `perPage` number

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- SubscriptionResponseDto[]
  - `id` number, required: Subscription identifier — pass this into the cancel/suspend/charge/transactions endpoints.
  - `cybersourceSubscriptionId` object, nullable, required: Same value received as `subscriptionId` in the `subscription.created` webhook payload. Null for a merchant_initiated subscription — there is no RBS-side subscription.
  - `status` 'created' | 'pending' | 'active' | 'delinquent' | 'suspended' | 'cancelled' | 'completed', required
  - `billingMode` 'rbs_scheduled' | 'merchant_initiated', required: rbs_scheduled — debited on a schedule by Cybersource RBS; merchant_initiated — charged on demand via POST /subscriptions/{id}/charge.
  - `frequency` 'weekly' | 'monthly', nullable, required: Null for a merchant_initiated subscription — charges are on-demand, not scheduled.
  - `amount` object, nullable, required: Null for a merchant_initiated subscription — charge amounts are per-call, not fixed.
  - `currency` string, required
  - `startDate` object, nullable, required: Null for a merchant_initiated subscription.
  - `customerId` string, required
  - `createdAt` string, date-time, required

## Other responses

- `401`: Wrong credentials
- `500`: Internal error

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/subscriptions/get.md)

---

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