ResourcesSubscriptions

Cancel a subscription immediately with a refund

To cancel immediately and refund the latest subscription payment, send cancelatperiodend: false with refundlastpayment: true.

To cancel immediately and refund the latest subscription payment, send cancel_at_period_end: false with refund_last_payment: true.

Set pro_rated_refund: true if you want a pro-rated refund instead of a full refund.

PATCH
/v2/subscriptions/{subscription}/cancel

Authorization

bearerAuth
AuthorizationBearer <token>

Provide your SellApp API key as a bearer token.

In: header

Path Parameters

subscription*integer

The subscription path parameter.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X PATCH "https://sell.app/api/v2/subscriptions/0/cancel" \  -H "Content-Type: application/json" \  -d '{    "cancel_at_period_end": true  }'
{
  "data": {
    "id": 123,
    "invoice_id": 456,
    "provider": "stripe",
    "subscription_id": "sub_1QwertyExample",
    "customer_id": "cus_Example123",
    "customer_email": "customer@example.com",
    "status": "ACTIVE",
    "current_period_start": "2026-03-01T00:00:00.000000Z",
    "current_period_end": "2026-04-01T00:00:00.000000Z",
    "cancel_at_period_end": true,
    "cancellation_in_progress": false,
    "store_id": 1,
    "product_variant_id": 99,
    "created_at": "2026-03-01T00:00:00.000000Z",
    "updated_at": "2026-03-23T00:00:00.000000Z"
  },
  "message": "Subscription will be cancelled at the end of the current period."
}