---
title: "List subscriptions"
method: GET
path: "/api/v1.4/subscriptions/"
tags: ["v1.1"]
---

# List subscriptions

`GET /api/v1.4/subscriptions/`

List subscriptions created

## Query parameters

- `custom_fields_name` string
- `custom_fields_value` string
- `limit` integer
- `offset` integer

## Response `200`

- PaginatedSubscriptionDetailsList
  - `count` integer
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` SubscriptionDetails[]
    - `id` string, required
    - `account` object, required
    - `plan` object, required — Plan ID subscription attached to.
    - `current_status` object, required — Subscription current status.
    - `statuses` unknown[], required — Subscription status history.
      - unknown
    - `start_date` string, date — Start date of subscription trial or subscription first cycle.
    - `customer` object, required — Customer UUID attached to the subscription.
    - `charge_automatically` boolean — Determine if the subscription invoice will be charged automatically using card token.
    - `primary_card_token` string, nullable, required
    - `remaining_recurring_cycles` integer, nullable — Number of remaining recurring cycles in the subscription life time, null if the subscription is forever.
    - `remaining_discount_cycles` integer, nullable — Number of recurring cycles to apply discount to, null if there is no discount.
    - `configuration` object, required — Subscription configuration attached to subscription.
    - `webhook_url` string, uri, nullable — A URL that the Moneyhash server will send a POST request to with subscription status updates.
    - `custom_fields` unknown
    - `due_invoices` object[], required — Due invoices to be paid.
    - `next_recurring_cycle_invoice` object, required — Start date of the next recurring cycle, null if the current date less than start date
    - `all_invoices` object, required — All invoices related to this subscription.
    - `is_live` boolean, required
    - `end_date` string, required
    - `created` string, date-time, required
    - `transactions` unknown[], required — All transactions created when invoices paid.
      - unknown
    - `scheduled_updates` unknown[], required — Subscription updates to be done.
      - unknown
    - `proration_credit_notes` unknown[], required — Credit notes from proration downgrades.
      - unknown
    - `payment_redirects` object, nullable, required — Payment redirect URLs from plan group level.
    - `flow` object, nullable, required — The data of the payment flow attached to the subscription if exists.
    - `card_tokenization_payment_intent` object, nullable, required — The subscription payment intent that is used for card tokenization when charge_automatically is true and primary_card_token is not provided in the subscription creation

## Other responses

- `401`

---

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