---
title: "Get Subscription"
method: GET
path: "/subscription/api/v1/subscriptions/{id}"
tags: ["Subscription Reads"]
---

# Get Subscription

`GET /subscription/api/v1/subscriptions/{id}`

It retrieves the details of a specific subscription.

## Path parameters

- `id` string, required

## Response `200`

Request Successful

- GetSubscriptionResponse
  - `success` boolean — Indicates if the request was successful.
  - `message` string — Descriptive message regarding the operation.
  - `data` object — The payload containing the comprehensive subscription information record.
    - `id` integer — Unique internal identifier for the subscription.
    - `customerId` string — Unique reference identifier assigned to the customer layer.
    - `customerEmail` string, email — The email address of the customer subscribing to the plan.
    - `firstName` string, nullable — First name of the customer.
    - `lastName` string, nullable — Last name of the customer.
    - `customerAuthorizedAt` string, date-time, nullable — Timestamp indicating when the customer explicitly authorized billing.
    - `status` string — The current operational status lifecycle of the subscription.
    - `currentPeriodStart` string, date-time — Timestamp tracking when the current billing sequence window opened.
    - `currentPeriodEnd` string, date-time — Timestamp tracking when the current billing sequence window closes.
    - `nextChargeDate` string, date-time — The next scheduled automated engine billing execution execution timestamp threshold.
    - `trialEndDate` string, date-time, nullable — Timestamp identifying when the free trial period lapses.
    - `pauseResumesAt` string, date-time, nullable — Timestamp representing when a paused schedule automatically restarts.
    - `cancelAt` string, date-time, nullable — Scheduled timestamp configuration for absolute future termination processing.
    - `pausedAt` string, date-time, nullable — Timestamp recording when the active schedule processing engine shifted states to paused.
    - `cancelledAt` string, date-time, nullable — Timestamp recording absolute terminal termination updates.
    - `cancellationReason` string, nullable — Contextual reason string note explaining termination logging context.
    - `cardExpiryAlertSent` boolean — Indicates if an alert sequence ran concerning upcoming authorization layer structural card expiration expiration checks.
    - `connectionMode` string — The environmental testing validation infrastructure state mode tag context indicator tracking setup routing.
    - `enrollmentReference` string — The core global billing reference signature token mapping authorized cards back safely.
    - `enrollmentTxnReference` string — Transaction identification string mapping core setup history back to initial setup requests.
    - `chargeMode` string — Operational pipeline signature processing rules template layout.
    - `metadata` object, nullable — Additional user defined parameter pairs mapping details to external data schemas.
    - `createdAt` string, date-time — System database initial tracking entry generation timestamp log.
    - `updatedAt` string, date-time — System database entry transaction state revision modifier timestamp log.
    - `customerBearsFee` boolean — Identifies if transaction processing merchant cost configurations pass directly onto subscriber layer dimensions.
    - `enrollConfirmed` boolean — Confirms card setup initialization authorization completely verified with partner bank switch engines.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/versions/1ecd4b94ff07/schema)