Fluid Commerce APIs (1.0)

The Fluid Commerce APIs provides a comprehensive set of APIs designed to integrate Fluid's powerful services into your applications seamlessly. This bundle offers robust functionality for enhancing messaging solutions, streamlining data management, and improving customer interactions. With detailed documentation, secure authentication, and flexible integration options, the Fluid Public API Bundle is engineered to help you leverage our services efficiently and effectively, unlocking new potentials and achieving greater connectivity within your systems.

Download OpenAPI description

swagger.json

swagger.yaml

Overview

E-mail support@fluid.app

License MIT

Servers

Mock server

https://docs.fluid.app/_mock/docs/apis/swagger/

Production server with company subdomain

https://{company}.fluid.app/

Local development server

http://fluid.lvh.me:{port}/

Agreements

Operations

ApplePay

Operations

Application Themes

Operations

ApplicationThemeTemplates

Operations

Authentication

Operations

Callback Definitions

Operations

Callback Registrations

Operations

Carts

Operations

Company Custom Catch Ups

Operations

Company Discounts

Operations

Company Droplets

Operations

Company Pages

Operations

Company Popups

Operations

Company Settings - Checkout

Operations

Company Settings - Countries

Operations

Company Settings - Languages

Operations

Company Settings - Warehouses

Operations

Contacts

Operations

Currencies

Operations

Customer Orders

Operations

CustomerNotes

Operations

Customers

Operations

Domains

Operations

Drop Zones

Operations

Droplets

Operations

Enrollment Packs

Operations

Enrollments

Operations

Fantasy Points

Operations

Fluid Pay

Operations

GlobalEmbeds

Operations

Inventory Levels

Operations

Multi-Factor Authentications

Operations

Notifications

Operations

Order Fulfillments

Operations

Orders

Operations

Pages

Operations

Payment

Operations

Payment Accounts

Operations

Payments

Operations

Paypal

Operations

Products

Operations

Public Companies

Operations

Redirects

Operations

Refunds

Operations

Roles

Operations

Subscription Orders

Operations

Subscription Plans

Operations

Subscriptions

Operations

List of subscriptions

Request

List all subscriptions

Query

pageinteger

Page number for pagination

Default 1

per_pageinteger

Number of records per page

Default 25

statusstring

Filter subscriptions by status (can be comma-separated for multiple values)

Enum"active""paused""cancelled"

subscription_plan_idinteger

Filter subscriptions by subscription plan ID

customer_idinteger

Filter subscriptions by customer ID

within_daysinteger

Filter subscriptions within number of days (e.g., last 7 days)

frequencystring

Filter subscriptions by billing frequency(e.g., monthly, weekly)

subscription_number_mininteger

Minimum subscription number for filtering

subscription_number_maxinteger

Maximum subscription number for filtering

amount_minnumber

Minimum amount for filtering

amount_maxnumber

Maximum amount for filtering

created_startstring(date)

Start date for created date range filter (format: YYYY-MM-DD)

created_endstring(date)

End date for created date range filter (format: YYYY-MM-DD)

next_bill_startstring(date)

Start date for next bill date range filter (format: YYYY-MM-DD)

next_bill_endstring(date)

End date for next bill date range filter (format: YYYY-MM-DD)

last_bill_startstring(date)

Start date for last bill date range filter (format: YYYY-MM-DD)

last_bill_endstring(date)

End date for last bill date range filter (format: YYYY-MM-DD)

next_ship_startstring(date)

Start date for next ship date range filter (format: YYYY-MM-DD)

next_ship_endstring(date)

End date for next ship date range filter (format: YYYY-MM-DD)

last_ship_startstring(date)

Start date for last ship date range filter (format: YYYY-MM-DD)

last_ship_endstring(date)

End date for last ship date range filter (format: YYYY-MM-DD)

last_failed_startstring(date)

Start date for last failed date range filter (format: YYYY-MM-DD)

last_failed_endstring(date)

End date for last failed date range filter (format: YYYY-MM-DD)

cancelled_startstring(date)

Start date for cancelled date range filter (format: YYYY-MM-DD)

cancelled_endstring(date)

End date for cancelled date range filter (format: YYYY-MM-DD)

sort_bystring

Sort field for subscriptions

Enum"created_at""id""next_bill_date""customer""last_bill_date""product""amount""status""frequency"

sort_directionstring

Sort direction

Default "desc"

Enum"asc""desc"

searchstring

Search term for subscriptions(searches across subscription plan names, customer details, and product titles)

curl -i -X GET \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions?amount_max=0&amount_min=0&cancelled_end=2019-08-24&cancelled_start=2019-08-24&created_end=2019-08-24&created_start=2019-08-24&customer_id=0&frequency=string&last_bill_end=2019-08-24&last_bill_start=2019-08-24&last_failed_end=2019-08-24&last_failed_start=2019-08-24&last_ship_end=2019-08-24&last_ship_start=2019-08-24&next_bill_end=2019-08-24&next_bill_start=2019-08-24&next_ship_end=2019-08-24&next_ship_start=2019-08-24&page=1&per_page=25&search=string&sort_by=created_at&sort_direction=asc&status=active&subscription_number_max=0&subscription_number_min=0&subscription_plan_id=0&within_days=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

sucess

Bodyapplication/json

subscriptionsArray of objects(Commerce::Subscription)required

subscriptions[].idintegerrequired

subscriptions[].next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscriptions[].last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscriptions[].next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscriptions[].last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscriptions[].statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscriptions[].disabledboolean or null

Default false

Example: false

subscriptions[].quantityinteger>= 1required

Default 1

Example: 1

subscriptions[].pricenumberrequired

Example: 100

subscriptions[].original_pricenumberrequired

Example: 100

subscriptions[].attemptsinteger or null

Default 0

Example: 1

subscriptions[].last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscriptions[].next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscriptions[].skipped_countinteger or null

Default 0

Example: 1

subscriptions[].max_skipsinteger or null

Example: 1

subscriptions[].trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscriptions[].cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscriptions[].created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscriptions[].updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscriptions[].notesstring or null

Example: "This is a sample commerce subscription"

subscriptions[].in_trialbooleanrequired

Example: false

subscriptions[].subscription_planobject(Commerce::SubscriptionPlan)required

subscriptions[].subscription_plan.idintegerrequired

subscriptions[].subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscriptions[].subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscriptions[].subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscriptions[].subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscriptions[].subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscriptions[].subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscriptions[].subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscriptions[].subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscriptions[].subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscriptions[].subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscriptions[].subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscriptions[].subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscriptions[].subscription_plan.activeboolean or null

Default true

Example: true

subscriptions[].subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscriptions[].subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscriptions[].customerobject(Customer)required

subscriptions[].customer.idintegerrequired

subscriptions[].customer.account_idstring or null

subscriptions[].customer.first_namestring or null

subscriptions[].customer.last_namestring or null

subscriptions[].customer.full_namestringrequired

subscriptions[].customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscriptions[].customer.verified_emailboolean or null

Default false

subscriptions[].customer.phonestring or null

subscriptions[].customer.orders_countinteger or null

Default 0

subscriptions[].customer.created_atstring(date-time)required

subscriptions[].customer.display_total_spentstringrequired

subscriptions[].customer.metadataobjectrequired

Default "{}"

subscriptions[].customer.user_company_idinteger or null

subscriptions[].customer.last_order_idinteger or null

Example: 101

subscriptions[].customer.notesstring or null

Example: "This is a note"

subscriptions[].customer.activebooleanrequired

subscriptions[].customer.total_spentnumber or stringrequired

Example: 100

subscriptions[].customer.customer_notesArray of objects(CustomerNote)required

subscriptions[].customer.customer_notes[].idintegerrequired

subscriptions[].customer.customer_notes[].notestringrequired

subscriptions[].customer.customer_notes[].user_idinteger or null

subscriptions[].customer.customer_notes[].customer_idintegerrequired

subscriptions[].customer.customer_notes[].resource_idinteger or null

subscriptions[].customer.customer_notes[].resource_typestring or null

subscriptions[].customer.customer_notes[].created_atstring(date-time)required

subscriptions[].customer.default_addressobject or null(Address)

subscriptions[].customer.addressesArray of objects(Address)required

subscriptions[].customer.addresses[].idintegerrequired

subscriptions[].customer.addresses[].namestringrequired

Example: "John Doe"

subscriptions[].customer.addresses[].address1stringrequired

Example: "123 Main St"

subscriptions[].customer.addresses[].address2string or null

Example: "Apt 4B"

subscriptions[].customer.addresses[].address3string or null

Example: "Building 5"

subscriptions[].customer.addresses[].citystringrequired

Example: "New York"

subscriptions[].customer.addresses[].statestringrequired

Example: "NY"

subscriptions[].customer.addresses[].subdivision_codestring or null

Example: "NY"

subscriptions[].customer.addresses[].postal_codestringrequired

Example: "10001"

subscriptions[].customer.addresses[].country_codestring or null

Example: "US"

subscriptions[].customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscriptions[].customer.addresses[].first_namestringrequired

Example: "John"

subscriptions[].customer.addresses[].last_namestringrequired

Example: "Doe"

subscriptions[].customer.active_subscriptions_countintegerrequired

Example: 10

subscriptions[].customer.inactive_subscriptions_countintegerrequired

Example: 10

subscriptions[].customer.jwtstringrequired

subscriptions[].customer.is_repbooleanrequired

Example: true

subscriptions[].variantobject(Variant)required

subscriptions[].variant.idintegerrequired

subscriptions[].variant.titlestring or null

Example: "Variant 1"

subscriptions[].variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscriptions[].variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscriptions[].variant.skustring or null

Example: "SKU-123456"

subscriptions[].variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscriptions[].variant.pricenumber or null

Example: 100

subscriptions[].variant.price_in_currencystringrequired

Example: "USD 100.00"

subscriptions[].variant.productobject(Product)required

subscriptions[].variant.product.idintegerrequired

subscriptions[].variant.product.titlestringrequired

subscriptions[].variant.product.image_urlstring or null

subscriptions[].variant.product.image_pathstring or null

subscriptions[].variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscriptions[].variant.product.cvinteger or null

Default 0

subscriptions[].variant.product.taxnumber or string or null

Default "0.0"

subscriptions[].variant.product.skustring or null

subscriptions[].variant.product.price_in_currencystringrequired

subscriptions[].variant.product.tax_in_currencystringrequired

subscriptions[].variant.product.cv_in_currencystringrequired

metaobject

Response

application/json

{
  "subscriptions": [
    { … }
  ],
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z",
    "pagination": { … }
  }
}

Create a subscription

Request

Create a subscription

Bodyapplication/json

subscriptionobjectrequired

subscription.subscription_plan_idintegerrequired

subscription.customer_idintegerrequired

subscription.variant_idintegerrequired

subscription.address_idintegerrequired

subscription.payment_method_idintegerrequired

subscription.order_item_idinteger

subscription.statusstring

subscription.disabledboolean

subscription.quantityinteger

subscription.metadataobject

subscription.notesstring

curl -i -X POST \
  https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "subscription": {
      "subscription_plan_id": 0,
      "customer_id": 0,
      "variant_id": 0,
      "address_id": 0,
      "payment_method_id": 0,
      "order_item_id": 0,
      "status": "string",
      "disabled": true,
      "quantity": 0,
      "metadata": {},
      "notes": "string"
    }
  }'

Responses

success

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Show a subscription

Request

Show a subscription

Path

idintegerrequired

Query

customer_idinteger

curl -i -X GET \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}?customer_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

sucess

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Update a subscription

Request

Update a subscription

Path

idintegerrequired

Bodyapplication/json

subscriptionobjectrequired

subscription.subscription_plan_idintegerrequired

subscription.customer_idintegerrequired

subscription.variant_idintegerrequired

subscription.address_idintegerrequired

subscription.payment_method_idintegerrequired

subscription.order_item_idinteger

subscription.statusstring

subscription.disabledboolean

subscription.quantityinteger

subscription.metadataobject

subscription.notesstring

curl -i -X PUT \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "subscription": {
      "subscription_plan_id": 0,
      "customer_id": 0,
      "variant_id": 0,
      "address_id": 0,
      "payment_method_id": 0,
      "order_item_id": 0,
      "status": "string",
      "disabled": true,
      "quantity": 0,
      "metadata": {},
      "notes": "string"
    }
  }'

Responses

sucess

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Pause a subscription

Request

Pause a subscription with a future resume date

Path

idintegerrequired

Query

customer_idintegerrequired

next_bill_datestring(date)required

curl -i -X POST \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}/pause?customer_id=0&next_bill_date=2019-08-24' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

success

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Resume a paused subscription

Request

Resume a previously paused subscription

Path

idintegerrequired

Query

customer_idintegerrequired

next_bill_datestring(date)

curl -i -X POST \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}/resume?customer_id=0&next_bill_date=2019-08-24' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

success

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Cancel a subscription

Request

Cancel a subscription

Path

idintegerrequired

Query

customer_idinteger

curl -i -X POST \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}/cancel?customer_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

sucess

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Reactivate a cancelled subscription

Request

Reactivate a previously cancelled subscription

Path

idintegerrequired

Query

customer_idintegerrequired

next_bill_datestring(date)

curl -i -X POST \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}/reactivate?customer_id=0&next_bill_date=2019-08-24' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

success

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Skip next billing

Request

Skip next billing

Path

idintegerrequired

Query

customer_idinteger

curl -i -X POST \
  'https://docs.fluid.app/_mock/docs/apis/swagger/api/subscriptions/{id}/skip_next_billing?customer_id=0' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

sucess

Bodyapplication/json

subscriptionobject(Commerce::Subscription)required

subscription.idintegerrequired

subscription.next_bill_datestring(date)required

Example: "2025-03-10T00:00:00Z"

subscription.last_bill_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.next_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.last_ship_datestring or null(date)

Example: "2025-03-10T00:00:00Z"

subscription.statusstringrequired

Enum"pending""active""paused""past_due""cancelled""trial"

Example: "active"

subscription.disabledboolean or null

Default false

Example: false

subscription.quantityinteger>= 1required

Default 1

Example: 1

subscription.pricenumberrequired

Example: 100

subscription.original_pricenumberrequired

Example: 100

subscription.attemptsinteger or null

Default 0

Example: 1

subscription.last_failed_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.next_retry_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.skipped_countinteger or null

Default 0

Example: 1

subscription.max_skipsinteger or null

Example: 1

subscription.trial_ends_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.cancelled_atstring or null(date-time)

Example: "2025-03-10T00:00:00Z"

subscription.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.notesstring or null

Example: "This is a sample commerce subscription"

subscription.in_trialbooleanrequired

Example: false

subscription.subscription_planobject(Commerce::SubscriptionPlan)required

subscription.subscription_plan.idintegerrequired

subscription.subscription_plan.namestringrequired

Example: "Test Subscription Plan"

subscription.subscription_plan.billing_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.billing_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.shipping_intervalinteger>= 1required

Default 1

Example: 1

subscription.subscription_plan.shipping_interval_unitstringrequired

Default "month"

Example: "day, week, month, year"

subscription.subscription_plan.trial_periodinteger or null>= 1

Example: 1

subscription.subscription_plan.trial_period_unitstring or null

Example: "day, week, month, year"

subscription.subscription_plan.allow_skippingboolean or null

Default true

Example: true

subscription.subscription_plan.max_skipsinteger or null>= 1

Example: 1

subscription.subscription_plan.price_adjustment_typestring or null

Example: "percentage or fixed_amount"

subscription.subscription_plan.price_adjustment_amountnumber or null

Example: 10

subscription.subscription_plan.max_quantityinteger or null>= 1

Example: 100

subscription.subscription_plan.activeboolean or null

Default true

Example: true

subscription.subscription_plan.created_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.subscription_plan.updated_atstring(date-time)required

Example: "2025-03-10T00:00:00Z"

subscription.customerobject(Customer)required

subscription.customer.idintegerrequired

subscription.customer.account_idstring or null

subscription.customer.first_namestring or null

subscription.customer.last_namestring or null

subscription.customer.full_namestringrequired

subscription.customer.emailstring\A[a-zA-Z0-9.!\#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-...required

subscription.customer.verified_emailboolean or null

Default false

subscription.customer.phonestring or null

subscription.customer.orders_countinteger or null

Default 0

subscription.customer.created_atstring(date-time)required

subscription.customer.display_total_spentstringrequired

subscription.customer.metadataobjectrequired

Default "{}"

subscription.customer.user_company_idinteger or null

subscription.customer.last_order_idinteger or null

Example: 101

subscription.customer.notesstring or null

Example: "This is a note"

subscription.customer.activebooleanrequired

subscription.customer.total_spentnumber or stringrequired

Example: 100

subscription.customer.customer_notesArray of objects(CustomerNote)required

subscription.customer.customer_notes[].idintegerrequired

subscription.customer.customer_notes[].notestringrequired

subscription.customer.customer_notes[].user_idinteger or null

subscription.customer.customer_notes[].customer_idintegerrequired

subscription.customer.customer_notes[].resource_idinteger or null

subscription.customer.customer_notes[].resource_typestring or null

subscription.customer.customer_notes[].created_atstring(date-time)required

subscription.customer.default_addressobject or null(Address)

subscription.customer.addressesArray of objects(Address)required

subscription.customer.addresses[].idintegerrequired

subscription.customer.addresses[].namestringrequired

Example: "John Doe"

subscription.customer.addresses[].address1stringrequired

Example: "123 Main St"

subscription.customer.addresses[].address2string or null

Example: "Apt 4B"

subscription.customer.addresses[].address3string or null

Example: "Building 5"

subscription.customer.addresses[].citystringrequired

Example: "New York"

subscription.customer.addresses[].statestringrequired

Example: "NY"

subscription.customer.addresses[].subdivision_codestring or null

Example: "NY"

subscription.customer.addresses[].postal_codestringrequired

Example: "10001"

subscription.customer.addresses[].country_codestring or null

Example: "US"

subscription.customer.addresses[].defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.customer.addresses[].first_namestringrequired

Example: "John"

subscription.customer.addresses[].last_namestringrequired

Example: "Doe"

subscription.customer.active_subscriptions_countintegerrequired

Example: 10

subscription.customer.inactive_subscriptions_countintegerrequired

Example: 10

subscription.customer.jwtstringrequired

subscription.customer.is_repbooleanrequired

Example: true

subscription.variantobject(Variant)required

subscription.variant.idintegerrequired

subscription.variant.titlestring or null

Example: "Variant 1"

subscription.variant.image_urlstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.image_pathstring or null

Example: "https://via.placeholder.com/150"

subscription.variant.skustring or null

Example: "SKU-123456"

subscription.variant.primary_imagestring or null

Example: "https://via.placeholder.com/150"

subscription.variant.pricenumber or null

Example: 100

subscription.variant.price_in_currencystringrequired

Example: "USD 100.00"

subscription.variant.productobject(Product)required

subscription.variant.product.idintegerrequired

subscription.variant.product.titlestringrequired

subscription.variant.product.image_urlstring or null

subscription.variant.product.image_pathstring or null

subscription.variant.product.pricenumber or string or null[ 0 .. 99999999 ]

Default "0.0"

subscription.variant.product.cvinteger or null

Default 0

subscription.variant.product.taxnumber or string or null

Default "0.0"

subscription.variant.product.skustring or null

subscription.variant.product.price_in_currencystringrequired

subscription.variant.product.tax_in_currencystringrequired

subscription.variant.product.cv_in_currencystringrequired

subscription.addressobject(Address)required

subscription.address.idintegerrequired

subscription.address.namestringrequired

Example: "John Doe"

subscription.address.address1stringrequired

Example: "123 Main St"

subscription.address.address2string or null

Example: "Apt 4B"

subscription.address.address3string or null

Example: "Building 5"

subscription.address.citystringrequired

Example: "New York"

subscription.address.statestringrequired

Example: "NY"

subscription.address.subdivision_codestring or null

Example: "NY"

subscription.address.postal_codestringrequired

Example: "10001"

subscription.address.country_codestring or null

Example: "US"

subscription.address.defaultboolean or null

Use this address by default when there are multiple addresses

Default false

Example: true

subscription.address.first_namestringrequired

Example: "John"

subscription.address.last_namestringrequired

Example: "Doe"

subscription.payment_methodobject(Commerce::PaymentMethod)required

subscription.payment_method.idintegerrequired

subscription.payment_method.sourcestringrequired

Enum"apple_pay""paypal""card""iap""bread""affirm""google_pay""klarna"

subscription.payment_method.payloadobject or null

subscription.payment_method.company_idinteger or null

subscription.payment_method.created_atstring(date-time)required

subscription.payment_method.updated_atstring(date-time)required

subscription.payment_method.user_idinteger or null

Example: 101

subscription.currencyobject(Currency)required

subscription.currency.idintegerrequired

subscription.currency.namestring or null

Example: "United States Dollar"

subscription.currency.codestringrequired

Example: "USD"

subscription.currency.ratenumber or string or null

Example: 1

subscription.currency.activeboolean or null

Default false

Example: true

subscription.currency.symbolstring or null

Example: "$"

subscription.countryobject(Country)required

subscription.country.idintegerrequired

subscription.country.namestringrequired

Example: "United States"

subscription.country.isostringrequired

2-letter country code (ISO 3166-1 alpha-2)

Example: "US"

subscription.companyobject(Company)required

subscription.company.idintegerrequired

subscription.subscription_skipsArray of objects(Commerce::SubscriptionSkip)required

subscription.subscription_skips[].idintegerrequired

subscription.subscription_skips[].skipped_datestring(date)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].reasonnull

Example: "Customer requested to skip next billing"

subscription.subscription_skips[].created_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.subscription_skips[].updated_atstring(date-time)required

Example: "2025-01-01T00:00:00Z"

subscription.ordersArray of objects(Commerce::Order)required

subscription.orders[].idintegerrequired

subscription.orders[].first_namestring or null

subscription.orders[].last_namestring or null

subscription.orders[].emailstring or null

subscription.orders[].phonestring or null

subscription.orders[].order_numberstring or null

subscription.orders[].statusstringrequired

Enum"awaiting_payment""awaiting_shipment""shipped""delivered""archived""cancelled""failed_payment""draft"

subscription.orders[].order_typestringrequired

Enum"requested""purchased""imported""abandoned"

subscription.orders[].amountnumber or string or null

Default "0.0"

subscription.orders[].notestring or null

subscription.orders[].currency_codestring or null

subscription.orders[].created_atstring(date-time)required

subscription.orders[].updated_atstring(date-time)required

subscription.orders[].metadataobject or null

Default "{}"

subscription.orders[].tokenstringrequired

subscription.orders[].refundable_amountstringrequired

metaobject

Response

application/json

{
  "subscription": {
    "id": 0,
    "next_bill_date": "2025-03-10T00:00:00Z",
    "last_bill_date": "2025-03-10T00:00:00Z",
    "next_ship_date": "2025-03-10T00:00:00Z",
    "last_ship_date": "2025-03-10T00:00:00Z",
    "status": "active",
    "disabled": false,
    "quantity": 1,
    "price": 100,
    "original_price": 100,
    "attempts": 1,
    "last_failed_at": "2025-03-10T00:00:00Z",
    "next_retry_at": "2025-03-10T00:00:00Z",
    "skipped_count": 1,
    "max_skips": 1,
    "trial_ends_at": "2025-03-10T00:00:00Z",
    "cancelled_at": "2025-03-10T00:00:00Z",
    "created_at": "2025-03-10T00:00:00Z",
    "updated_at": "2025-03-10T00:00:00Z",
    "notes": "This is a sample commerce subscription",
    "in_trial": false,
    "subscription_plan": { … },
    "customer": { … },
    "variant": { … },
    "address": { … },
    "payment_method": { … },
    "currency": { … },
    "country": { … },
    "company": { … },
    "subscription_skips": [ … ],
    "orders": [ … ]
  },
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Tracking Informations

Operations

Tree Nodes

Operations

Trees

Operations

Users

Operations

Variant Countries

Operations

Webhooks

Operations

returns a list of all droplet categories

Request

curl -i -X GET \
  https://docs.fluid.app/_mock/docs/apis/swagger/api/droplet_categories \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

returns a list of droplet categories

Bodyapplication/json

droplet_categoriesArray of objects(DropletCategory)

metaobject

Response

application/json

{
  "droplet_categories": [
    { … }
  ],
  "meta": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2021-01-01T00:00:00Z"
  }
}

Fluid Commerce APIs (1.0)

Agreements

ApplePay

Application Themes

ApplicationThemeTemplates

Authentication

Callback Definitions

Callback Registrations

Carts

Company Custom Catch Ups

Company Discounts

Company Droplets

Company Pages

Company Popups

Company Settings - Checkout

Company Settings - Countries

Company Settings - Languages

Company Settings - Social Media

Company Settings - Warehouses

Contacts

Currencies

Customer Orders

CustomerNotes

Customers

Domains

Drop Zones

Droplets

Enrollment Packs

Enrollments

Fantasy Points

Fluid Pay

GlobalEmbeds

Inventory Levels

Multi-Factor Authentications

Notifications

Order Fulfillments

Orders

Pages

Payment

Payment Accounts

Payments

Paypal

Products

Public Companies

Redirects

Refunds

Roles

Shares

Subscription Orders

Subscription Plans

Subscriptions

List of subscriptions

Request

Responses

Was this helpful?

Create a subscription

RequestExpand all

Responses

Was this helpful?

Show a subscription

Request

Responses

Was this helpful?

Update a subscription

RequestExpand all

Responses

Was this helpful?

Pause a subscription

Request

Responses

Was this helpful?

Resume a paused subscription

Request

Responses

Was this helpful?

Cancel a subscription

Request

Responses

Was this helpful?

Reactivate a cancelled subscription

Request

Request