**Version: 202601**

# List recurring application charges

**GET** `/openapi/2026-01/recurring_application_charges`

Retrieve a paginated list of recurring application charges created for the current store.

## Request

**Query Parameters**

- `cursor` string

  Cursor for pagination
- `page_size` int32

  Number of records per page. Defaults to 8
- `charges_status` string

  Filter by charge status:

  *   `pending`: pending
  *   `accepted`: accepted
  *   `declined`: declined
  *   `active`: active
  *   `expired`: expired
  *   `frozen`: frozen
  *   `cancelled`: cancelled
  *   `paid_failed`: payment failed
  *   `paying`: paying

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `recurring_application_charges` object[]

    List of recurring application charges

    *   Array \[

    - `id` string

      Recurring application charge ID
    - `application_id` string

      Application ID
    - `name` string

      Charge name shown to the merchant
    - `price` string

      Recurring charge amount
    - `capped_amount` string

      Capped amount for usage-based billing
    - `terms` string

      Terms and conditions text shown to the merchant for usage-based billing
    - `return_url` string

      URL the merchant returns to after confirming the charge
    - `confirmation_url` string

      URL the merchant is redirected to in order to confirm the charge
    - `status` string

      Current status of the recurring application charge
    - `trial_days` int32

      Number of trial days offered for the subscription
    - `activated_on` string

      Date when the subscription was activated
    - `trial_ends_on` string

      Date when the trial period ends
    - `billing_on` string

      Next billing date
    - `cancelled_on` string

      Charge cancellation date
    - `cancel_sub_on` string

      Subscription cancellation date
    - `test` boolean

      Whether this is a test charge
    - `created_at` string

      Creation time, in ISO-8601 format
    - `updated_at` string

      Last update time, in ISO-8601 format
    - `charge_interval_days` int32

      Charge interval in days
    *   \]
  - `cursor` string

    Cursor for pagination
  - `has_more` boolean

    Whether there are more records

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "recurring_application_charges": [
      {
        "id": "string",
        "application_id": "string",
        "name": "string",
        "price": "string",
        "capped_amount": "string",
        "terms": "string",
        "return_url": "string",
        "confirmation_url": "string",
        "status": "string",
        "trial_days": 0,
        "activated_on": "string",
        "trial_ends_on": "string",
        "billing_on": "string",
        "cancelled_on": "string",
        "cancel_sub_on": "string",
        "test": true,
        "created_at": "string",
        "updated_at": "string",
        "charge_interval_days": 0
      }
    ],
    "cursor": "string",
    "has_more": true
  }
}
```