POST
/
v1
/
subscriptions
/
{id}

Headers

x-api-key
string
required

Path Parameters

id
string
required

Body

application/json
items
object[]

List of subscription items to update/create. If no item ID is provided, the item will be created.

Response

200 - application/json
collection_method
string
required

The method used for collecting payments for the subscription.

created_at
string
required

The date and time when the subscription was created.

customer
object
required

The customer who owns the subscription.

id
string
required

Unique identifier for the object.

mode
enum<string>
required

String representing the environment.

Available options:
test,
live,
sandbox
object
string
required

String representing the object’s type. Objects of the same type share the same value.

product
object
required

The product associated with the subscription.

status
enum<string>
required

The current status of the subscription.

Available options:
active,
canceled,
unpaid,
paused,
trialing
updated_at
string
required

The date and time when the subscription was last updated.

canceled_at
string

The date and time when the subscription was canceled, if applicable.

current_period_end_date
string

The end date of the current subscription period.

current_period_start_date
string

The start date of the current subscription period.

items
object[]

Subscription items.

last_transaction_date
string

The date of the last paid transaction.

last_transaction_id
string

The ID of the last paid transaction.

next_transaction_date
string

The date when the next subscription transaction will be charged.