# List Subscriptions

Retrieve a paginated list of all subscriptions associated with your API profile, sorted by timestamp in descending order (most recent first).

**Notes:**
  * Returns up to 50 subscriptions per page.
  * Requires a valid API Key with access to the profile.
  * Results are automatically sorted by creation timestamp, with the newest subscriptions appearing first.
  * Use pagination parameters to navigate through multiple pages of results.

**Method:** `GET`

**Path:** ```
https://api.blockbee.io/subscription/list/
```

---

## Parameters

### Query Parameters

- **`apikey`** (`string`) (required) - Example: `your_api_key_here`: API Key provided by BlockBee's [Dashboard](https://dash.blockbee.io/). Unsure how to get yours? [Check this tutorial](/kb/tutorials/dashboard/how-to-generate-a-new-api-key).

**Note:** The API key can also be sent as a header named `apikey`.

- **`p`** (`integer`) - Example: `1`: Page number for pagination. Defaults to 1.

---

## Returns

Returns a paginated list of subscriptions.

- **`status`** (`string`): Status of the request.

- **`subscriptions`** (`object[]`): List of subscriptions tied to the API profile.

  - **`token`** (`string`): Token associated with the subscription.

  - **`url`** (`string`): Subscription or payment link for the customer.

  - **`active`** (`boolean`): Indicates if the subscription is active.

  - **`user_id`** (`string`): User identifier in your system.

  - **`user_email`** (`string`): Customer e-mail.

  - **`end_date_ts`** (`integer`): Timestamp of the subscription's expiration (may be null).

  - **`payment_list`** (`object[]`): List of completed payments for the subscription.

  - **`token`** (`string`): Token for the specific payment.

  - **`value`** (`string`): The value of the payment.

  - **`coin`** (`string`): The cryptocurrency used for the payment.

  - **`duration_ts`** (`integer`): Duration in seconds.

  - **`received_fiat`** (`string`): FIAT amount received for the payment.

  - **`is_paid`** (`boolean`): `true` if the payment is paid.

  - **`is_pending`** (`boolean`): `true` if the payment is pending blockchain confirmation.

  - **`is_partial`** (`boolean`): `true` if the payment is partially paid.

- **`num_pages`** (`integer`): Total number of pages available.



## Example Response

```json
{
  "status": "success",
  "subscriptions": [
    {
      "token": "J78yEgW01HIOGZqBeqzxpXFuCwHGQgdO",
      "url": "https://pay.blockbee.io/subscription/J78yEgW01HIOGZqBeqzxpXFuCwHGQgdO/",
      "active": true,
      "user_id": "user_example",
      "user_email": "example@mail.com",
      "end_date_ts": 1753022709,
      "payment_list": [
        {
          "token": "Wd1lggEvyy1usHooflFiEGNQbBn4TNvJ",
          "value": "1.99",
          "coin": "usd",
          "duration_ts": 2592000,
          "received_fiat": "1.99",
          "is_paid": true,
          "is_pending": false,
          "is_partial": false
        }
      ]
    }
  ],
  "num_pages": 1
}
```