---
title: "List subscription payments"
method: GET
path: "/subscription"
tags: ["Subscription Payment"]
---

# List subscription payments

`GET /subscription`

Full report with all the subscriptions payments from your Account Id

**Required scope:** <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">subscription:read</code>

## Query parameters

- `page` number
- `records_per_page` number
- `expiration_time` string
- `method` string
- `customer` string
- `id` string
- `key` string
- `created_at` string
- `status` string
- `value` string

## Response `200`

OK

- object
  - `data` SubscriptionResponseOnList[]
    - `id` string, uuid
    - `key` string
    - `expiration_time` string, date-time
    - `start_time` string, date-time
    - `frequency` '1D' | '1W' | '2W' | '1M' | '2M' | '3M' | '4M' | '6M' | '1Y' | '2Y' | '3Y'
    - `retries` integer
    - `max_captures` integer
    - `failover` boolean
    - `capture_now` boolean
    - `unlimited_payments` boolean
    - `customer` CustomerResponseOnList — Customer information as returned in list responses (may contain masked/partial data for privacy)
      - `id` string
      - `name` string — Customer name (may be partially masked for privacy)
      - `email` string — Customer email (may be partially masked for privacy)
      - `phone` string — Customer phone (may be partially masked for privacy)
      - `phone_indicative` string — Phone country code
      - `fiscal_number` string — Fiscal number (may be partially masked for privacy)
      - `key` string — Customer key
      - `language` string — Customer preferred language
    - `method` SubscriptionMethodResponseOnList
      - `type` 'CC' | 'DD'
      - `status` 'active' | 'inactive' | 'waiting'
      - `url` string, uri
      - `sdd_mandate` SddMandateResponseOnList — SDD Mandate information as returned in list responses (contains masked data for privacy)
        - `id` string — Mandate ID
        - `iban` string — IBAN (partially hidden for data security reasons)
        - `key` string — Mandate key
        - `name` string — Account holder name (partially hidden for data security reasons)
        - `email` string — Account holder email (partially hidden for data security reasons)
        - `phone` string — Account holder phone (partially hidden for data security reasons)
        - `account_holder` string — Account holder name (partially hidden for data security reasons)
        - `country_code` string — Country code
        - `max_num_debits` string — Maximum number of debits allowed
        - `billing_entity` string — Billing entity identifier
    - `currency` string — The currency code in ISO 4217 format (e.g., "EUR" for Euro). This field specifies the type of currency used in financial operation.
    - `value` number, double
    - `created_at` string, date-time
  - `meta` Meta — Metadata object containing pagination and result information for list responses.
    - `page` object — Pagination details
      - `current` integer — Current page number
      - `total` integer — Total number of pages
    - `records` object — Record details
      - `per_page` integer — Number of records per page
      - `total` integer — Total number of records
    - `links` object — Navigation links for pagination
      - `first` string — Link to the first page
      - `prev` string — Link to the previous page
      - `next` string — Link to the next page
      - `last` string — Link to the last page

## Other responses

- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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