---
title: "ListSubscriptionEvents"
method: GET
path: "/v2/subscriptions/{subscription_id}/events"
tags: ["Subscriptions"]
---

# ListSubscriptionEvents

`GET /v2/subscriptions/{subscription_id}/events`

Lists all events for a specific subscription.
In the current implementation, only `START_SUBSCRIPTION` and `STOP_SUBSCRIPTION` (when the subscription was canceled) events are returned.

## Path parameters

- `subscription_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Success

- ListSubscriptionEventsResponse — Defines the fields that are included in the response from the [ListSubscriptionEvents](https://developer.squareup.com/reference/square_2021-08-18/subscriptions-api/list-subscription-events) endpoint.
  - `cursor` string — When a response is truncated, it includes a cursor that you can use in a subsequent request to fetch the next set of events. If empty, this is the final response. For more information, see [Pagination](https://developer.squareup.com/docs/working-with-apis/pagination).
  - `errors` Error[] — Information about errors encountered during the request.
    - `category` string, required — The high-level category for the error.
    - `code` string, required — The specific code of the error.
    - `detail` string — A human-readable description of the error for debugging purposes.
    - `field` string — The name of the field provided in the original request (if any) that the error pertains to.
  - `subscription_events` SubscriptionEvent[] — The `SubscriptionEvents` retrieved.
    - `effective_date` string, required — The date, in YYYY-MM-DD format (for example, 2013-01-15), when the subscription event went into effect.
    - `id` string, required — The ID of the subscription event.
    - `info` unknown
    - `plan_id` string, required — The ID of the subscription plan associated with the subscription.
    - `subscription_event_type` string, required — Type of the subscription event.

---

[API](https://skmtc.net/square/apis/squareup.md) · [All operations](https://skmtc.net/square/apis/squareup/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/square/squareup/versions/8d95e3639487/schema)