List subscription actions
List the lifecycle actions recorded against one subscription, newest first.
Every lifecycle action a subscription has accepted is recorded, whether it was started from the customer portal, your store's dashboard, or an API token. A request refused by the capability check returns 422 and is not recorded. Actions are returned newest first, unlike the subscription list, and the order cannot be changed.
Provide your SellApp API key as a bearer token.
In: header
Path Parameters
The productSubscription path parameter.
Query Parameters
Number of items to return per page.
151 <= value <= 100Page number to return.
11 <= valueSet to false to return at most 100 matching items in one data array without pagination links or metadata.
trueHeader Parameters
Store slug. Required for OAuth access tokens. API keys may omit it to use their current store, or the first accessible store when no current store is selected.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://sell.app/api/v2/subscriptions/124/actions" \ -H "X-STORE: launch-lab"{
"data": [
{
"id": 4192,
"product_subscription_id": 124,
"subscription_id": null,
"action": "change_plan",
"status": "expired",
"provider": "internal",
"proration_order_id": 90210,
"error": "Plan change expired before its proration invoice was paid.",
"customer_message": null,
"confirmed_at": null,
"failed_at": "2026-07-05T09:12:00.000000Z",
"created_at": "2026-07-03T09:12:00.000000Z",
"updated_at": "2026-07-05T09:12:00.000000Z"
},
{
"id": 4188,
"product_subscription_id": 124,
"subscription_id": null,
"action": "change_plan",
"status": "confirmed",
"provider": "internal",
"proration_order_id": 89744,
"error": null,
"customer_message": null,
"confirmed_at": "2026-06-03T09:14:00.000000Z",
"failed_at": null,
"created_at": "2026-06-03T09:12:00.000000Z",
"updated_at": "2026-06-03T09:14:00.000000Z"
}
],
"links": {
"first": "https://sell.app/api/v2/subscriptions/124/actions?page=1",
"last": "https://sell.app/api/v2/subscriptions/124/actions?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://sell.app/api/v2/subscriptions/124/actions",
"per_page": 15,
"to": 2,
"total": 2,
"links": [
{
"url": null,
"label": "« Previous",
"active": false
},
{
"url": "https://sell.app/api/v2/subscriptions/124/actions?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next »",
"active": false
}
]
}
}{
"type": "invalid_request_error",
"code": "bad_request",
"message": "The request could not be understood.",
"status": 400,
"param": null,
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#bad-request"
}{
"type": "authentication_error",
"code": "unauthenticated",
"message": "Unauthenticated.",
"status": 401,
"param": null,
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#unauthenticated"
}{
"type": "authorization_error",
"code": "forbidden",
"message": "This action is unauthorized.",
"status": 403,
"param": null,
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#forbidden"
}{
"type": "not_found_error",
"code": "resource_not_found",
"message": "Not Found.",
"status": 404,
"param": null,
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#resource-not-found"
}{
"type": "validation_error",
"code": "validation_failed",
"message": "The selected product variant id is invalid.",
"status": 422,
"param": "product_variant_id",
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#validation-failed",
"errors": {
"product_variant_id": [
"The selected product variant id is invalid."
]
}
}{
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"message": "Too Many Attempts.",
"status": 429,
"param": null,
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#rate-limit-exceeded"
}{
"type": "api_error",
"code": "api_error",
"message": "Server Error",
"status": 500,
"param": null,
"request_id": "01992a65-e064-71ba-b38f-902b7966a6be",
"docs_url": "https://sell.app/docs/api/errors#api-error"
}