Skip to main content

Bold Subscriptions (1.0)

Download OpenAPI specification:Download

Bold Subscriptions customers use our API to interact with subscription data in unique ways. This includes the ability to modify, cancel, and report on subscriptions.

Refer to the changelog for the latest updates to this API.

Subscriptions

Contains information about subscriptions for your store and data associated with them. Use these endpoints to get, remove, edit, or list subscriptions.

List Subscriptions

Retrieve a list of subscriptions.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

query Parameters
subscription_status
any
Enum: "active" "inactive" "processing" "scheduled" "paused"
Example: subscription_status=active

Status of the subscriptions returned. Multiple statuses can be passed as an array.

bold_platform_customer_id
any
Example: bold_platform_customer_id=1

Customer Id of the subscriptions returned. Multiple customer ids can be passed as an array.

expand
string
Value: "customer"
Example: expand=customer

Fields to expand on the subscription. Multiple fields can be passed as an array

limit
integer
Example: limit=5

Maximum number of results to be returned

filter
string
Example: filter=?filter=lt(next_order_datetime:2021-11-15T00:00:00Z)+gt(next_order_datetime:2021-10-31T00:00:00Z)

Accepts filtering options as described on the Query & Pagination page. For example, to filter the next order date by a date interval, you could use the following parameter:

cursor
string
Example: cursor=?cursor= P3NpbmNlX2lkPTE1Mjc0Jm9yZGVyX2J5PWlkJm9yZGVyX2RpcmVjdGlvbj1kZXNj

Returns the next page of results if supplied the next value from the previous pagination results.

Responses

Response samples

Content type
application/json
{
  • "subscriptions": [
    ],
  • "pagination": {
    }
}

Create Subscription

For more information about this endpoint, refer to Create Subscriptions.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

Request Body schema: application/json
object
object

Responses

Request samples

Content type
application/json
{
  • "customer": {
    },
  • "subscription": {
    }
}

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Get Subscription

Retrieve a subscription by its id.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Update Subscription

Update a subscription by its id.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Request Body schema: application/json
object (SubscriptionEntity)
external_id
required
string or null
customer
required
any
next_order_datetime
required
string
next_payment_datetime
required
string
next_processing_datetime
required
string
subscription_status
required
string
Enum: "active" "inactive" "paused" "scheduled" "processing" "app_uninstalled" "waiting_sca_authorization"
payment_method_token
required
string
payment_gateway_public_id
required
string or null
payment_rrule
required
string
payment_rrule_text
required
string or null
order_rrule
required
string
order_rrule_text
required
string or null
last_payment_datetime
required
string or null
last_order_datetime
required
string or null
last_processed_datetime
required
string or null
current_retries
required
integer
charged_currency
required
string
base_to_charged_exchange_rate
required
integer
base_currency
required
string
object (CustomerAddressEntity)
object or null
idempotency_key
required
string
placed_at
string or null <data-time>
discount_code
required
string
billing_address_id
required
integer
shipping_address_id
required
integer
orders_processed
integer or null
last_failure_code
string or null
Enum: "alt_pp_payment_method_required" "bigcommerce_error" "card_declined" "card_expired" "credit_card_not_found" "discount_code_use_limit" "insufficient_funds" "invalid_billing_address" "invalid_bold_api_token" "invalid_card_expiration_month" "invalid_card_expiration_year" "invalid_card_number" "invalid_customer_email" "invalid_discount_code" "invalid_payment_method" "invalid_security_code" "invalid_shipping_address" "invalid_zip_code" "no_payment_provider" "payment_method_declined" "plugin_event_failed" "shopify_error" "stripe_support_required" "transaction_declined" "out_of_stock_product" "unaccepted_credit_card" "unknown_error" "unsupported_card" "unsupported_purchase_type" "unsupported_shipping_address" "woocommerce_error"

This code may help to identify the type of the error.

object or null

Default error messages for the last_failure_code field

last_failure_reason
string or null
Enum: "credit_card" "gateway" "cashier" "platform" "inventory" "other"

The reason for the failure

note
required
string or null

An internal-only note that you can add to a subscription. For a subscription recurrence, this note appears in the Additional Details section of the created order. Applicable for Shopify Checkout only.

order_note
required
string or null

A customer-facing note that you can add to a subscription. For the first order, this field retains the note added by the customer. For a subscription recurrence, this note appears in the Note section of the created order. Applicable for Shopify Checkout only.

order_count
integer

The number of orders created for the subscription.

Responses

Request samples

Content type
application/json
{
  • "subscription": {
    }
}

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Partial Update Subscription

Partially update a subscription by its id.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Request Body schema: application/json
object (PartialUpdateSubscriptionEntity)
current_retries
integer
note
string or null

An internal-only note that you can add to a subscription. For a subscription recurrence, this note appears in the Additional Details section of the created order. Applicable for Shopify Checkout only.

order_note
string or null

A customer-facing note that you can add to a subscription. For the first order, this field retains the note added by the customer. For a subscription recurrence, this note appears in the Note section of the created order. Applicable for Shopify Checkout only.

order_count
integer

The number of orders created for the subscription.

Responses

Request samples

Content type
application/json
{
  • "subscription": {
    }
}

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

List Subscription Intervals

Retrieve a list of available intervals for a subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "intervals": [
    ]
}

Update Subscription Interval

Update the interval of a subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_interval_id
required
integer

Subscription interval ID to view and manage data for.

subscription_id
required
integer

Subscription ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Create Line Items

Add one or more line items to a subscription. Refer to Create Subscription Line Items for more information about the use cases of this endpoint.

Note: Adding line items to multi-currency subscriptions is not supported at this time.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Request Body schema: application/json
Array of objects
Array
platform_product_id
string

The ID of the product on your platform. Learn more about finding platform product IDs.

platform_variant_id
string

The ID of the product variant on your platform. All products, including those with no variants or a single variant, have a platform variant ID. Learn more about finding platform variant IDs.

quantity
integer

The quantity of this line item within the subscription.

price
integer

The price of this line item within the subscription, in the base unit (e.g., cents) of the charged_currency for this subscription. For example, a value of 1000 in a USD currency corresponds to a $10.00 USD per-unit price on the line item.

subscription_group_id
integer

The ID of the subscription group that contains the discount you want to add to this line item. Learn more about finding subscription group IDs.

Responses

Request samples

Content type
application/json
{
  • "line_items": [
    ]
}

Response samples

Content type
application/json
{
  • "line_items": [
    ]
}

Reactivate Subscription

Reactivate an inactive or cancelled subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Cancel Subscription

Cancel a subscription and any future orders. Cancelled subscriptions will appear as 'inactive'.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Pause Subscription

Pause a subscription and any future orders. Paused orders will still appear as 'active'.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Subscription Groups

Contains information about subscription groups for your store, including shop ID and subscription group configuration. Use these endpoints to add, remove, edit, or list subscription groups.

List Selection Options

Retrieves a list of selection options. Selection options are the products available in a subscription group. Use this endpoint to view some or all selection options for the active subscription groups on a given store.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

query Parameters
cursor
string
Example: cursor=?cursor=P2lkPTU1

A base 64 encoded cursor.

filter
string
Example: filter=?filter=in(platform_entity_id:1,2,3)

Accepts filtering options as described on the Query & Pagination page.

expand
string
Example: expand=?expand=subscription_group&expand=products

Fields to expand on the selection options. Currently accepts subscription_group and products

limit
integer
Example: limit=?limit=3L9

Limit the number of returned items.

latest
boolean
Default: false
Example: latest=true

If set to true, returns the most recent selection option for each distinct platform_entity_id in the response.

This is useful when using the expand=subscription_group query parameter by returning only the most recent subscription group a product was added to.

Responses

Response samples

Content type
application/json
{
  • "selection_options": [
    ],
  • "pagination": {
    }
}

List Subscription Groups

Retrieve a list of subscription groups.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

Responses

Response samples

Content type
application/json
{
  • "subscription_groups": [
    ]
}

Create Subscription Group

Create a subscription group.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

Request Body schema: application/json
object (SubscriptionGroupEntity)
internal_name
required
string
is_enabled
required
boolean
platform_id
required
string
allow_prepaid
required
boolean
is_prepaid_only
required
boolean
should_continue_prepaid
required
boolean
continue_prepaid_type
required
string
Enum: "as_prepaid" "as_standard"
allow_buffer_days
required
boolean
discount_type
required
string
Enum: "no_discount" "percentage" "fixed"
percent_discount
required
number
fixed_discount
required
integer
minimum_order_count_before_cancellable
required
integer
is_product_swappable
required
boolean
is_subscription_only
required
boolean
selection_type
required
string
Enum: "products" "collections"
group_type
required
string
Enum: "selectable" "fixed"
selectable_daily_allowed
required
boolean
selectable_weekly_allowed
required
boolean
selectable_yearly_allowed
required
boolean
selectable_max_interval_frequency
required
integer
fixed_interval_type
required
string
Enum: "daily" "weekly" "monthly" "yearly"
is_fixed_billing
required
boolean
can_add_to_cart
required
boolean
required
Array of objects (BillingRuleEntity)
required
Array of objects (SelectionOptionEntity)
required
Array of objects (PrepaidDuration)

Responses

Request samples

Content type
application/json
{
  • "subscription_group": {
    }
}

Response samples

Content type
application/json
{
  • "subscription_group": {
    }
}

Get Subscription Group

Retrieve a subscription group by its id.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

group_id
required
integer

Subscription group ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription_group": {
    }
}

Update Subscription Group

Update a subscription group by its id.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

group_id
required
integer

Subscription group ID to view and manage data for.

Request Body schema: application/json
object (SubscriptionGroupEntity)
internal_name
required
string
is_enabled
required
boolean
platform_id
required
string
allow_prepaid
required
boolean
is_prepaid_only
required
boolean
should_continue_prepaid
required
boolean
continue_prepaid_type
required
string
Enum: "as_prepaid" "as_standard"
allow_buffer_days
required
boolean
discount_type
required
string
Enum: "no_discount" "percentage" "fixed"
percent_discount
required
number
fixed_discount
required
integer
minimum_order_count_before_cancellable
required
integer
is_product_swappable
required
boolean
is_subscription_only
required
boolean
selection_type
required
string
Enum: "products" "collections"
group_type
required
string
Enum: "selectable" "fixed"
selectable_daily_allowed
required
boolean
selectable_weekly_allowed
required
boolean
selectable_yearly_allowed
required
boolean
selectable_max_interval_frequency
required
integer
fixed_interval_type
required
string
Enum: "daily" "weekly" "monthly" "yearly"
is_fixed_billing
required
boolean
can_add_to_cart
required
boolean
required
Array of objects (BillingRuleEntity)
required
Array of objects (SelectionOptionEntity)
required
Array of objects (PrepaidDuration)

Responses

Request samples

Content type
application/json
{
  • "subscription_group": {
    }
}

Response samples

Content type
application/json
{
  • "subscription_group": {
    }
}

Delete Subscription Group

Delete a subscription group by its id.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

group_id
required
integer

Subscription group ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "error": "invalid_request",
  • "error_description": "The access token is missing"
}

Delete Selection Option by ID

Delete a selection option from inside a subscription group.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

group_id
required
integer

Subscription group ID to view and manage data for.

selection_option_id
required
string

Selection option ID of the item to be deleted from the group.

Responses

Delete Selection Option by Filter

Delete one or more selection options from inside a subscription group.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

group_id
required
integer

Subscription group ID to view and manage data for.

query Parameters
filter
required
string

Accepts filtering options as described here: https://developer.boldcommerce.com/guides/getting-started/query-pagination. Example: to remove the platform product IDs 1, 2 and 3 from a subscription group, the following query param must be added: ?filter=in(platform_entity_id:1,2,3)

Responses

Add Selection Options by Platform Product ID(s)

Add one or more selection options from inside a subscription group.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

group_id
required
integer

Subscription group ID to view and manage data for.

Request Body schema: application/json

Add one or more selection options to a subscription group. Right now the only supported selection option is product. A list of platform product IDs can be passed as platform_entity_ids.

required
object
required
object
platform_entity_ids
required
Array of integers

These are product ids we are look

Responses

Request samples

Content type
application/json
{
  • "subscription_group": {
    }
}

Subscription Line Items

A child resource of Subscriptions. Contains information about line items in a subscription, including price, details, and swappable products. Use these endpoints to get, remove, edit, or list line items for subscriptions.

Swap Line Items

Swap line item products on a subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Request Body schema: application/json
Array of objects (SwapProductEntity)
Array
line_item_id
integer
platform_product_id
string
platform_variant_id
string
subscription_group_id
integer

Responses

Request samples

Content type
application/json
{
  • "swap_products": [
    ]
}

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Update Line Items

Update the line items of a subscription. Refer to Manage Subscription Line Items for more information about the use cases of this endpoint.

When updating the price of the line item, change the price field in the request body. This value must be in the charged_currency of the subscription, and it must be in the base currency unit (i.e., cents). This price is the final output price of the line item on this order; any applicable subscription group discounts or price changes will not be applied.

Example: If you include price: 4000 in the request body, the line item price is set to $40.00 CAD for all upcoming orders.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

Request Body schema: application/json
object
Array of objects (PatchLineItemEntity)
Array
id
required
integer or null

Read-only.

Line item identifier.

subscription_id
required
integer or null

Read-only.

Subscription identifier.

platform_id
required
string

Read-only.

Identifier from the platform.

platform_product_id
required
string or null

Read-only.

Product identifier from the platform.

platform_variant_id
required
string or null

Read-only.

Variant identifier from the platform.

subscription_group_id
required
integer

Subscription group identifier.

subscription_group_billing_rules_id
required
integer or null

Billing rules identifier for the subscription group.

title
required
string

Line item title.

product_name
required
string or null

Read-only.

Product name.

variant_name
required
string or null

Read-only.

Variant name.

sku
required
string

Product SKU.

url
required
string

Read-only.

Product URL.

image
required
string

Product image.

quantity
required
integer

Product quantity.

price
integer or null

Product price. If changed, all related price fields may be impacted. If omitted, the price will be used from the exising line item when updating or the matching product when adding a new line item.

price_charged
required
integer or null

Read-only.

Influenced by changes made to the price field.

discounted_price
required
integer

Read-only.

Influenced by changes made to the price field.

discounted_price_charged
required
integer

Read-only.

Influenced by changes made to the price field.

full_price
required
integer

Read-only.

Influenced by changes made to the price field.

full_price_charged
integer

Read-only.

Influenced by changes made to the price field.

requires_shipping
required
boolean

Whether or not the line item requires shipping.

grams
required
integer

Product weight in grams.

weight
required
number

Product weight in weight_unit.

weight_unit
required
string

Unit used for weight.

taxable
required
boolean

Whether or not the line item is taxable.

required
Array of objects (LineItemDiscountEntity)

Read-only.

All discounts associated with the line item.

prepaid_metadata
required
object or null
Value: null

Read-only.

Prepaid properties, as defined in the Create Line Item Prepaid Metadata and Update Line Item Prepaid Metadata endpoint. Set to null when using the Update Subscription Line Items endpoint.

Array of objects (LineItemAttributeEntity)

Read-only.

Additional attributes associated with the line item.

Use the Update Line Item Attributes endpoint to add, update, or delete line item attributes.

Responses

Request samples

Content type
application/json
{
  • "subscription": {
    }
}

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Delete Line Item

Delete a line item from a subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription": {
    }
}

Get Line Item

Retrieve the details of a specific line item from a given subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

Responses

Response samples

Content type
application/json
{
  • "subscription_line_item": {
    }
}

List Swappable Products by Line Item

Retrieve a list of swappable products for a subscription line item.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

query Parameters
limit
integer

Maximum number of results to be returned

page
integer

The desired page number for the paginated result

Responses

Response samples

Content type
application/json
{}

Create Line Item Attributes

Add a new set of attributes to a line item.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

Request Body schema: application/json
Array of objects (LineItemAttributeEntity)
Array
name
string

The name of the custom field/attribute, up to 250 characters.

value
string

The content of the custom field/attribute.

Responses

Request samples

Content type
application/json
{
  • "line_item_attributes": [
    ]
}

Response samples

Content type
application/json
{
  • "line_item_attributes": [
    ]
}

Update Line Item Attributes

Create, remove, or update attributes for a specific line item inside a subscription. Your request payload must contain the full list of attributes for the line item.

To add an attribute to the line item, include a new attribute in the request payload. To update an attribute that already exists on the line item, include the attribute in the payload with the same name and an updated value. To delete one attribute, leave the attribute out of the request payload. To remove all attributes of a line item, use an empty array as the request payload.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

Request Body schema: application/json
Array of objects (LineItemAttributeEntity)
Array
name
string

The name of the custom field/attribute, up to 250 characters.

value
string

The content of the custom field/attribute.

Responses

Request samples

Content type
application/json
{
  • "line_item_attributes": [
    ]
}

Response samples

Content type
application/json
{
  • "subscription_line_item": {
    }
}

Create Line Item Prepaid Metadata

Add prepaid metadata to a line item to convert a subscription to prepaid. Adding this metadata to one line item converts the whole order to prepaid.

Note: Converting a subscription to prepaid does not automatically charge the customer for the balance of the prepaid subscription. To charge the customer the prepaid subscription amount on the next recurrence, set prepaid_duration to the same value as prepaid_recurrence_count, and set prepaid_continue to as_prepaid. This causes Bold to start a new prepaid subscription on the next recurrence and set the prepaid_recurrence_count back to 1.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

Request Body schema: application/json
object (PrepaidMetadataEntity)
id
integer

The ID of the prepaid metadata.

line_item_id
integer

The ID of the subscription line item this prepaid metadata belongs to.

prepaid_continue
required
string
Enum: "no_continue" "as_prepaid" "as_standard"

The behavior of the subscription once the number of recurrences has reached the prepaid_duration.

  • no_continue: The subscription will be cancelled.
  • as_prepaid : The customer will be charged for new set of order recurrences on the next recurrence.
  • as_standard: The subscription will be converted to a standard subscription, where the customer is charged for one order at each recurrence.
prepaid_duration
required
integer

The number of subscription recurrences that have been prepaid.

current_recurrence_count
required
integer

The number of subscription recurrences that have occurred.

Responses

Request samples

Content type
application/json
{
  • "prepaid_metadata": {
    }
}

Response samples

Content type
application/json
{
  • "prepaid_metadata": {
    }
}

Update Line Item Prepaid Metadata

Update or create new prepaid metadata for a line item.

Note: Updating the prepaid_duration or current_recurrence_count does not result in any automatic charges or change in charges to an existing prepaid customer. Adding new prepaid metadata to a subscription converts it to prepaid. For more information on converting a subscription to prepaid, refer to the Create Line Item Prepaid Metadata endpoint.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

line_item_id
required
integer

Line item ID to view and manage data for.

Request Body schema: application/json
object (PrepaidMetadataEntity)
id
integer

The ID of the prepaid metadata.

line_item_id
integer

The ID of the subscription line item this prepaid metadata belongs to.

prepaid_continue
required
string
Enum: "no_continue" "as_prepaid" "as_standard"

The behavior of the subscription once the number of recurrences has reached the prepaid_duration.

  • no_continue: The subscription will be cancelled.
  • as_prepaid : The customer will be charged for new set of order recurrences on the next recurrence.
  • as_standard: The subscription will be converted to a standard subscription, where the customer is charged for one order at each recurrence.
prepaid_duration
required
integer

The number of subscription recurrences that have been prepaid.

current_recurrence_count
required
integer

The number of subscription recurrences that have occurred.

Responses

Request samples

Content type
application/json
{
  • "prepaid_metadata": {
    }
}

Response samples

Content type
application/json
{
  • "prepaid_metadata": {
    }
}

Subscription Orders

A child resource of Subscriptions. Contains information about orders in a subscription, including schedules, order histories, and current orders. Use these endpoints to list, get, skip, or unskip orders.

List Orders

Retrieve a list of subscription orders for a subscription.

Authorizations:
OAuthTokenAPIAccessToken
path Parameters
shop_identifier
required
string
Example: 123456

The unique identifier of the shop.

subscription_id
required
integer

Subscription ID to view and manage data for.

query Parameters
page
integer

The desired page number for the paginated result

limit
integer

Maximum number of results to be returned

Responses

Response samples

Content type
application/json
{
  • "subscription_orders": [