ThriveCart Subscriptions API

The Subscriptions API from ThriveCart — 4 operation(s) for subscriptions.

Documentation GitHub OpenAPI

Business capability

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /cancelSubscription Cancel a subscription · Cancel a subscription #

Ask an LLM

“How do I cancel a customer's recurring subscription?”

“Which IDs do I need to cancel a subscription?”

Tell an agent destructive · confirm first

Cancel subscription {subscription_id} on order {order_id}.

Stop billing for subscription {subscription_id} from order {order_id} permanently.

POST /refund Refund a transaction · Refund a transaction #

Ask an LLM

“How do I refund a customer's purchase?”

“Can I refund a single item from an order by its reference?”

Tell an agent destructive · confirm first

Refund item {reference} on order {order_id}.

Issue a refund for order {order_id}, purchase reference {reference}.

POST /pauseSubscription Pause a subscription · Pause a subscription #

Ask an LLM

“How do I put a customer's subscription on hold?”

“Can a paused subscription resume automatically on a set date?”

Tell an agent

Pause subscription {subscription_id} on order {order_id} indefinitely.

Pause subscription {subscription_id} on order {order_id} and auto-resume at {auto_resume}.

POST /resumeSubscription Resume a paused subscription · Resume a subscription #

Ask an LLM

“How do I restart a subscription I paused?”

“Can I unpause a customer's subscription right away?”

Tell an agent

Resume subscription {subscription_id} on order {order_id}.

Unpause subscription {subscription_id} from order {order_id} now.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/thrivecart:thrivecart-subscriptions-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: ThriveCart Subscriptions API
  version: '1'
  description: The ThriveCart API lets you read and manage the products, bumps, upsells, downsells, transactions, customers, subscriptions, affiliates and Learn students in a ThriveCart account, and to create targeted event subscriptions (webhooks).
  termsOfService: https://thrivecart.com/legal/thrivecart/
  contact:
    name: ThriveCart Developer Support
    url: https://developers.thrivecart.com/
    email: support@thrivecart.com
servers:
- url: https://thrivecart.com/api/external
  description: Production
security:
- bearerAuth: []
- oauth2: []
tags:
- name: Subscriptions
paths:
  /cancelSubscription:
    post:
      operationId: cancelASubscription
      summary: Cancel a subscription
      description: Cancel a subscription using the order ID and subscription ID pulled from either a Transaction search or the full history of a customer.
      tags:
      - Subscriptions
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                order_id:
                  type: string
                  description: Order ID
                subscription_id:
                  type: string
                  description: Subscription ID
              required:
              - order_id
              - subscription_id
      responses:
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                Invalid_parameters:
                  value:
                    error: You do not have permission to access this subscription.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '200':
          description: Cancel a subscription
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
              examples:
                Cancel_a_subscription:
                  value:
                    success: true
                    message: This subscription has been successfully cancelled.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '401':
          description: Unauthorized - the API key or access token is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                auth_missing:
                  value:
                    error: auth.missing
                invalid_token:
                  value:
                    error: invalid_token
                    error_description: The access token provided is invalid
        '429':
          description: Too Many Requests - the account has exceeded 60 requests per minute.
      security:
      - bearerAuth: []
      - oauth2: []
  /refund:
    post:
      operationId: refundATransaction
      summary: Refund a transaction
      description: Refund a specific transaction using the order ID and purchase reference pulled from either a Transaction search or the full history of a customer.
      tags:
      - Subscriptions
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                order_id:
                  type: string
                  description: Order ID
                reference:
                  type: string
                  description: Item reference
              required:
              - order_id
              - reference
      responses:
        '200':
          description: Refund a transaction
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
              examples:
                Refund_a_transaction:
                  value:
                    success: true
                    message: This refund has been issued successfully.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '404':
          description: Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                Invalid_parameters:
                  value:
                    error: The requested charge could not be identified.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '401':
          description: Unauthorized - the API key or access token is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                auth_missing:
                  value:
                    error: auth.missing
                invalid_token:
                  value:
                    error: invalid_token
                    error_description: The access token provided is invalid
        '429':
          description: Too Many Requests - the account has exceeded 60 requests per minute.
      security:
      - bearerAuth: []
      - oauth2: []
  /pauseSubscription:
    post:
      operationId: pauseASubscription
      summary: Pause a subscription
      description: 'Pause a subscription using the order ID and subscription ID pulled from either a Transaction search or the full history of a customer.


        Note that you can provide an optional timestamp to automatically resume the subscription on that date, or leave this blank to pause indefinitely.'
      tags:
      - Subscriptions
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                order_id:
                  type: string
                  description: Order ID
                subscription_id:
                  type: string
                  description: Subscription ID
                auto_resume:
                  type: string
                  description: (Optional) Unix timestamp to automatically resume this subscription - must be 24 hours in the future
              required:
              - order_id
              - subscription_id
      responses:
        '200':
          description: Pause a subscription
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  customer_id:
                    type: string
                  frequency:
                    type: string
                  plan_id:
                    type: string
                  message:
                    type: string
              examples:
                Pause_a_subscription:
                  value:
                    success: true
                    customer_id: cus_I7ZKYD0DfM1vz0
                    frequency: month
                    plan_id: thrivecart-1-product-1-12500-month-usd
                    message: This subscription has been successfully paused.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                Invalid_parameters:
                  value:
                    error: You must provide a valid order ID.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '401':
          description: Unauthorized - the API key or access token is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                auth_missing:
                  value:
                    error: auth.missing
                invalid_token:
                  value:
                    error: invalid_token
                    error_description: The access token provided is invalid
        '429':
          description: Too Many Requests - the account has exceeded 60 requests per minute.
      security:
      - bearerAuth: []
      - oauth2: []
  /resumeSubscription:
    post:
      operationId: resumeASubscription
      summary: Resume a subscription
      description: Resume a subscription using the order ID and subscription ID pulled from either a Transaction search or the full history of a customer.
      tags:
      - Subscriptions
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              type: object
              properties:
                order_id:
                  type: string
                  description: Order ID
                subscription_id:
                  type: string
                  description: Subscription ID
              required:
              - order_id
              - subscription_id
      responses:
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
              examples:
                Invalid_parameters:
                  value:
                    error: You must provide a valid order ID.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '200':
          description: Resume a subscription
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  subscription_id:
                    type: string
                  message:
                    type: string
              examples:
                Resume_a_subscription:
                  value:
                    success: true
                    subscription_id: sub_IMaXasOaNCuHqo
                    message: This subscription has been successfully resumed.
          headers:
            X-ThriveCart-Account-Name:
              description: X-ThriveCart-Account-Name
              schema:
                type: string
              example: myaccount
            X-ThriveCart-Account-URL:
              description: X-ThriveCart-Account-URL
              schema:
                type: string
              example: https://myaccount.thrivecart.com/
        '401':
          description: Unauthorized - the API key or access token is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                auth_missing:
                  value:
                    error: auth.missing
                invalid_token:
                  value:
                    error: invalid_token
                    error_description: The access token provided is invalid
        '429':
          description: Too Many Requests - the account has exceeded 60 requests per minute.
      security:
      - bearerAuth: []
      - oauth2: []
components:
  schemas:
    Error:
      type: object
      description: ThriveCart error envelope. Not RFC 9457 problem+json.
      properties:
        error:
          type: string
          description: Machine-readable error key.
        error_description:
          type: string
          description: Human-readable description, when present.
      required:
      - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Account-scoped API key created under Settings > API & webhooks > API tokens, or an OAuth access token, sent as `Authorization: Bearer <token>`.'
    oauth2:
      type: oauth2
      description: OAuth 2.0 authorization code grant for applications acting on behalf of another ThriveCart account. ThriveCart does not publish a scope reference; access is granted account-wide on consent.
      flows:
        authorizationCode:
          authorizationUrl: https://thrivecart.com/authorization/new
          tokenUrl: https://thrivecart.com/authorization/token
          scopes: {}
externalDocs:
  description: ThriveCart Developers
  url: https://developers.thrivecart.com/documentation/

ThriveCart Subscriptions API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification