---
title: "Get a list of all subscriptions"
method: GET
path: "/subscription"
tags: ["Subscriptions"]
---

# Get a list of all subscriptions

`GET /subscription`

Retrieves a list of all subscriptions that the user has permission to view.

## Query parameters

- `entity_code` string, nullable — Parameter to filter subscriptions by entity code
- `min_subscription_date` string, date, nullable — Parameter to filter subscriptions by minimum subscription date
- `max_subscription_date` string, date, nullable — Parameter to filter subscriptions by maximum subscription date
- `min_maturity_date` string, date, nullable — Parameter to filter subscriptions by minimum maturity date
- `max_maturity_date` string, date, nullable — Parameter to filter subscriptions by maximum maturity date
- `limit` integer — Page size used for pagination
- `offset` integer — Offset used for pagination

## Response `200`

List of subscriptions

- PaginatedSubscriptions — PaginatedSubscriptions schema.
  - `pageInfo` PageInfo, required — PageInfo schema.
    - `hasNextPage` boolean, nullable, required — Boolean indicating if there is a next page of items available
    - `hasPreviousPage` boolean, nullable, required — boolean indicating if there is a previous page
    - `limit` integer, nullable, required — Limit or page size set (used for pagination)
    - `offset` integer, nullable, required — Offset of items (used for pagination)
    - `totalCount` integer, nullable, required — Total number of items available
  - `subscriptions` Subscription[], required
    - `amount` number, required — Subscription amount
    - `cellCode` string, required — Cell code
    - `currency` string, required — Subscription currency
    - `cutoffDatetime` string, date-time, required — Cut-off datetime for this subscription (timezone aware). Last point at which the subscription's maturity action can be changed before TreasurySpring locks it in.
    - `entityCode` string, required — Subscribing Entity Code
    - `holdingUid` string, nullable — Holding uid
    - `indicationUid` string, nullable — Indication uid
    - `maturityAction` string, required — Maturity action
    - `maturityDate` string, date, required — Date the holding will mature
    - `obligorExposureCode` string, required — Obligor exposure code
    - `obligorExposureName` string, required — Obligor exposure name
    - `productCode` string, required — Product code
    - `releaserEmail` string, nullable — Releaser email
    - `signerEmail` string, nullable — Signer email
    - `source` string, required — Source of funds
    - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED' | 'CANCELLED' | 'EXPIRED', required
    - `subscriptionDate` string, date, required — The date to subscribe to the indication
    - `uid` string, required — Subscription uid
    - `yield` number, nullable — Yield agreed at subscribe time (annualised APY).

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/treasuryspring/apis/treasuryspring-public-api.md) · [All operations](https://skmtc.net/treasuryspring/apis/treasuryspring-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryspring/treasuryspring-public-api/versions/d587dda25444/schema)