---
title: "Get a single subscription by id"
method: GET
path: "/subscription/{entity_code}/{uid}"
tags: ["Subscriptions"]
---

# Get a single subscription by id

`GET /subscription/{entity_code}/{uid}`

Retrieves a single subscription if the user has permission to view it. Useful for tracking a
subscription returned by `/subscribe` until its `holdingUid` is populated. Once `holdingUid`
exists, treat the holding as the live source of truth.

## Path parameters

- `entity_code` string, required — Entity code
- `uid` string, required — Subscription uid

## Response `200`

Subscription information

- Subscription — Subscription schema.
  - `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)