# Retrieves a list of subscriptions

Retrieve a list of subscriptions that have been created for your account. The subscriptions are sorted, with the most recent first.

Endpoint: GET /subscriptions
Version: v1
Security: apiKey

## Security:

  - `apiKey` (unknown)
    http bearer API key

## Response 200:

  - `200` (unknown)
    subscriptions found

## Response 200 fields (application/json):

  - `type` (string, required)
    Enum: "list"

  - `data` (array, required)

  - `data.id` (string, required)

  - `data.type` (string, required)
    Enum: "subscription"

  - `data.description` (string, required)

  - `data.subscription_type` (string, required)
    Enum: "direct_debit"

  - `data.state` (string, required)

  - `data.currency` (string, required)
    Enum: "EUR"

  - `data.created_at` (string, required)

  - `data.start_at` (string, required)

  - `data.cancel_at` (string, required)

  - `data.customer` (string, required)

  - `data.mandate` (string, required)

  - `data.scheduling` (string)
    Enum: "manual", "automatic"

  - `data.cancel_periods_on_cancellation` (boolean)

  - `data.period` (object, required)

  - `data.period.amount` (integer, required)

  - `data.period.vat` (number, required)

  - `data.period.multiplier` (integer, required)

  - `data.period.interval` (string, required)
    Enum: "day", "week", "month", "year"

  - `data.first_period` (object, required)

  - `data.first_period.amount` (integer, required)

  - `data.first_period.vat` (number, required)

  - `data.first_period.multiplier` (integer)

  - `data.first_period.interval` (string)
    Enum: "day", "week", "month", "year"

  - `data.payment_details` (object, required)

  - `data.payment_details.return_url` (string, required)

  - `data.payment_details.cancel_url` (string, required)

  - `data.next_period_date` (string, required)

  - `data.available_until` (string, required)

  - `data.metadata` (object, required)

  - `data._links` (object, required)

  - `data._links.self` (string, required)

  - `data._links.customer` (string)

  - `data._links.mandate` (string)

  - `data._links.checkout` (string)

  - `count` (integer, required)

  - `_links` (object, required)

  - `_links.self` (string, required)

  - `_links.next` (string)

  - `_links.prev` (string)