---
title: "Retrieve Subscriptions"
method: GET
path: "/api/v1/subscriptions/{id}/"
tags: ["Subscriptions"]
---

# Retrieve Subscriptions

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

## Path parameters

- `id` string, required

## Response `200`

- SubscriptionSer
  - `subscription_id` string, required
  - `reference` string, nullable — Third-party reference ID
  - `customer` CustomerSer, required
    - `customer_id` string, required
    - `email` string, email, required
    - `first_name` string, required
    - `last_name` string, required
    - `reference` string, nullable — Third-party reference ID
    - `address` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `zipcode` string, nullable
    - `country` union
      - 'KE' | 'GH' | 'NG' | 'UG' | 'TZ' | 'CM' | 'BF' | 'CI' — Supported disbursement countries: - `KE` - Kenya (KES) - `GH` - Ghana (GHS) - `NG` - Nigeria (NGN) - `UG` - Uganda (UGX) - `TZ` - Tanzania (TZS) - `CM` - Cameroon (XAF) - `BF` - Burkina Faso (XOF) - `CI` - Ivory Coast (XOF)
      - ''
      - unknown
    - `created_at` string, date-time, nullable, required
    - `updated_at` string, date-time, nullable, required
  - `plan` PlanSer, required
    - `name` string, required
    - `plan_id` string, required
    - `frequency` integer, required
    - `frequency_unit` 'D' | 'W' | 'M' | 'Y' — * `D` - day * `W` - week * `M` - month * `Y` - year
    - `billing_cycles` integer — How many times should we bill the customer
    - `currency` 'KES' | 'GHS' | 'NGN' | 'UGX' | 'TZS' | 'XAF' | 'XOF', required — Supported currencies: - `KES` - Kenyan Shilling (KE) - `GHS` - Ghanaian Cedi (GH) - `NGN` - Nigerian Naira (NG) - `UGX` - Ugandan Shilling (UG) - `TZS` - Tanzanian Shilling (TZ) - `XAF` - Central African CFA Franc (CM) - `XOF` - West African CFA Franc (BF, CI)
    - `amount` string, decimal, required
    - `reference` string, nullable — Third-party/Internal reference ID
    - `plan_url` string, required
    - `redirect_url` string, uri, nullable — Redirect your customer after successful payment
    - `created_at` string, date-time, nullable, required
    - `updated_at` string, date-time, nullable, required
  - `payment_method` 'CARD-PAYMENT' — * `CARD-PAYMENT` - CARD-PAYMENT
  - `card_mask` string, nullable, required — Masked card
  - `card_type` union
    - 'Visa' | 'MasterCard' | 'AMEX' | 'Discover' | 'Unknown' — * `Visa` - Visa * `MasterCard` - MasterCard * `AMEX` - AMEX * `Discover` - Discover * `Unknown` - Unknown
    - ''
    - unknown
  - `card_expiry` string, date, nullable, required
  - `status` 'PENDING' | 'ACTIVE' | 'CANCELED' | 'COMPLETE' | 'FAILED' — * `PENDING` - PENDING * `ACTIVE` - ACTIVE * `CANCELED` - CANCELED * `COMPLETE` - COMPLETE * `FAILED` - FAILED
  - `start_date` string, date, required
  - `next_date` string, date, nullable
  - `completed_cycles` integer
  - `fail_reason` string, nullable
  - `setup_url` string, required
  - `redirect_url` string, uri, nullable — Redirect your customer after successful payment
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/intasend/apis/intasend-api.md) · [All operations](https://skmtc.dev/intasend/apis/intasend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/intasend/intasend-api/revisions/9fd63286a2c8/schema)