---
title: "List Subscriptions"
method: GET
path: "/api/v1/subscriptions/"
tags: ["Subscriptions"]
---

# List Subscriptions

`GET /api/v1/subscriptions/`

## Query parameters

- `customer` integer
- `page` integer
- `plan` integer
- `record_id` string
- `reference` string
- `status` 'ACTIVE' | 'CANCELED' | 'COMPLETE' | 'FAILED' | 'PENDING'
- `updated_at_after` string, date
- `updated_at_before` string, date

## Response `200`

- PaginatedSubscriptionSerList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` SubscriptionSer[], required
    - `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)