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

# List subscriptions

`GET /api/v1.4/customers/{customer_uuid}/subscriptions/`

List customer subscriptions

## Path parameters

- `customer_uuid` string, required

## Response `200`

- DocsResponse200CustomerSubscriptions
  - `data` CustomerSubscriptions, required
    - `customer_subscriptions` SubscriptionDetails[], required
      - `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
    - `active_subscriptions_count` integer, required
  - `status` DocsStatus, required
    - `data` unknown, required
  - `count` integer, nullable, required — Total number of items.
  - `next` string, nullable, required — Next page url if exists
  - `previous` string, nullable, required — Previous page url if exists

## Other responses

- `400`
- `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)