Cancel Subscription

POST

/v1/billing/subscriptions/{subscription_id}/cancel

Record a subscription cancellation.

Parameters

Path Parameters

subscription_id

required

Subscription Id

string

Request Body ^required

SubscriptionCancelRequest

Request body to record a subscription cancellation.

object

cancelled_at

required

Cancelled At

string format: date-time

reason

Any of:

string

string

null

null

Responses

200

Successful Response

Response[SubscriptionRead]

object

data

required

SubscriptionRead

Full representation of a Subscription record.

object

id

required

Id

string format: uuid

created_at

required

Created At

string format: date-time

updated_at

required

Updated At

string format: date-time

paddle_subscription_id

required

Paddle Subscription Id

string

paddle_customer_id

required

Paddle Customer Id

string

paddle_plan_id

required

Paddle Plan Id

string

paddle_status

required

Paddle Status

string

plan_name

required

Plan Name

string

is_free_trial

required

Is Free Trial

boolean

start_date

required

Start Date

string format: date-time

end_date

Any of:

string

string format: date-time

null

null

auto_renew

required

Auto Renew

boolean

cancelled_at

Any of:

string

string format: date-time

null

null

billing_cycle

required

Billing Cycle

string

per_cycle_billing_amount

required

Per Cycle Billing Amount

integer

billing_address_line_1

required

Billing Address Line 1

string

billing_address_line_2

Any of:

string

string

null

null

billing_city

required

Billing City

string

billing_state

required

Billing State

string

billing_zip

required

Billing Zip

string

billing_country

required

Billing Country

string

billing_email

required

Billing Email

string

billing_phone

required

Billing Phone

string

billing_contact_name

required

Billing Contact Name

string

send_invoice_days_before_due

required

Send Invoice Days Before Due

integer

send_email_receipts

required

Send Email Receipts

boolean

send_paper_receipts

required

Send Paper Receipts

boolean

meta

ResponseMeta

Metadata included in every response envelope.

object

request_id

Any of:

string

string

null

null

organization_id

Any of:

string

string

null

null

422

Validation Error

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object