# 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

## Response 200 fields (application/json):

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

  - `data` (array, required)
    Example: [{"id":"PSV1QACRO4DSMQT0KK","type":"subscription","description":"Test subscription","currency":"EUR","subscription_type":"direct_debit","state":"active","start_at":null,"created_at":"2023-07-24T12:40:10Z","cancel_at":null,"customer":"CU7JRN6W6K3DA9","mandate":"MD6ULYXJ4HP9RJ","scheduling":"automatic","cancel_periods_on_cancellation":false,"period":{"amount":"1000","vat":"21","multiplier":1,"interval":"month"},"first_period":{"amount":"1000","vat":"21","multiplier":1,"interval":"month"},"payment_details":{"return_url":null,"cancel_url":null},"next_period_date":null,"available_until":null,"metadata":{},"_links":{"self":"https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}}]

  - `data.id` (string, required)
    Example: "PSV1QACRO4DSMQT0KK"

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

  - `data.description` (string, required)
    Example: "Test subscription"

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

  - `data.state` (string, required)
    Example: "active"

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

  - `data.created_at` (string, required)
    Example: "2023-07-24T12:40:10Z"

  - `data.start_at` (string,null, required)

  - `data.cancel_at` (string,null, required)

  - `data.customer` (string,null, required)
    Example: "CU7JRN6W6K3DA9"

  - `data.mandate` (string,null, required)
    Example: "MD6ULYXJ4HP9RJ"

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

  - `data.cancel_periods_on_cancellation` (boolean)

  - `data.period` (object,null, required)
    Example: {"amount":"1000","vat":"21","multiplier":1,"interval":"month"}

  - `data.period.amount` (integer, required)
    Example: "1000"

  - `data.period.vat` (number, required)
    Example: "21"

  - `data.period.multiplier` (integer, required)
    Example: 1

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

  - `data.first_period` (object,null, required)
    Example: {"amount":"1000","vat":"21","multiplier":1,"interval":"month"}

  - `data.first_period.amount` (integer, required)
    Example: "1000"

  - `data.first_period.vat` (number, required)
    Example: "21"

  - `data.first_period.multiplier` (integer)
    Example: 1

  - `data.first_period.interval` (string)
    Enum: same as `data.period.interval` (4 values)

  - `data.payment_details` (object, required)
    Example: {"return_url":null,"cancel_url":null}

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

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

  - `data.next_period_date` (string,null, required)

  - `data.available_until` (string,null, required)

  - `data.metadata` (object, required)
    Example: {}

  - `data._links` (object, required)
    Example: {"self":"https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK","customer":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9","mandate":"https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"}

  - `data._links.self` (string, required)
    Example: "https://api.paypro.nl/subscriptions/PSV1QACRO4DSMQT0KK"

  - `data._links.customer` (string)
    Example: "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"

  - `data._links.mandate` (string)
    Example: "https://api.paypro.nl/mandates/MD6ULYXJ4HP9RJ"

  - `data._links.checkout` (string)

  - `count` (integer, required)

  - `_links` (object, required)

  - `_links.self` (string, required)

  - `_links.next` (string)

  - `_links.prev` (string)