Skip to content
🔧 Admin APIs
/
/
Cancel pending downgrade...

External (0.0.1)

Download OpenAPI description
admin-api-swagger.json
admin-api-swagger.yaml
Languages
Servers
https://membership-admin.appstle.com

Shipping & Delivery Profiles

APIs for managing Shopify delivery profiles, shipping rates, zones, and free shipping configuration for subscription memberships

Operations

Customer Discount History

APIs for retrieving historical discount code usage and redemption information for membership contracts

Operations

Cancellation Flow Configuration

APIs for managing membership cancellation flow settings including retention offers, survey questions, and cancel confirmation screens

Operations

Billing & Orders

APIs for managing membership billing attempts, recurring orders, payment retries, order history, and order skipping

Operations

One-Time Add-Ons

APIs for managing one-time product additions to upcoming subscription orders, including adding, retrieving, and removing one-off items

Operations

Membership Plans

APIs for managing membership/subscription plan groups, including creating plans, configuring discounts, billing intervals, and assigning products to plans

Operations

Product Bundles

APIs for managing subscription product bundles, bundle configurations, item grouping, and bundle-specific discount codes

Operations

Custom CSS Styling

APIs for retrieving custom CSS styles applied to subscription widgets and customer portal for theme customization

Operations

Customer Portal Configuration

APIs for managing customer portal settings including UI customization, text labels, feature toggles, and branding options for the member self-service portal

Operations

Membership Contracts

APIs for managing membership/subscription contracts including creation, updates, status changes, line items, discounts, and billing operations

Operations

Get pending downgrade for a subscription contract

Request

Retrieves the pending/scheduled downgrade details for a specific subscription contract. This endpoint returns information about a downgrade that has been scheduled but not yet executed.

Response Information:

  • contractId: The subscription contract ID
  • waitTillTimestamp: When the downgrade will be executed
  • oldVariantId: The current product variant ID
  • newVariantId: The target product variant ID after downgrade
  • oldPrice: Current subscription price
  • newPrice: New price after downgrade
  • sellingPlanId: The selling plan ID for the new subscription
  • sellingPlanName: Name of the selling plan

Use Cases:

  • Check if a customer has a pending downgrade scheduled
  • Display pending downgrade information in custom dashboards
  • Verify downgrade details before allowing further modifications

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

Path
contractIdinteger(int64)required

The subscription contract ID

Example: 12345
Query
api_keystring

API Key (Deprecated - Use Header X-API-Key instead)

Headers
X-API-Keystring
curl -i -X GET \
  'https://membership-admin.appstle.com/api/external/v2/subscription-contract-details/12345/pending-downgrade?api_key=string' \
  -H 'X-API-Key: string'

Responses

Pending downgrade found and returned successfully

Bodyapplication/json
shopstring
contractIdinteger(int64)
waitTillTimestampstring
oldLineIdstring
oldVariantIdstring
newVariantIdstring
sellingPlanIdstring
sellingPlanNamestring
oldPricenumber(double)
newPricenumber(double)
newCustomerTagstring
oldCustomerTagsstring
newOrderTagstring
eventSourcestring
retryCountinteger(int32)
customerIdinteger(int64)
executionArnstring
Response
application/json
{
  "shop": "string",
  "contractId": 0,
  "waitTillTimestamp": "string",
  "oldLineId": "string",
  "oldVariantId": "string",
  "newVariantId": "string",
  "sellingPlanId": "string",
  "sellingPlanName": "string",
  "oldPrice": 0.1,
  "newPrice": 0.1,
  "newCustomerTag": "string",
  "oldCustomerTags": "string",
  "newOrderTag": "string",
  "eventSource": "string",
  "retryCount": 0,
  "customerId": 0,
  "executionArn": "string"
}

Cancel pending downgrade for a subscription contract

Request

Cancels a scheduled/pending downgrade for a specific subscription contract. This endpoint removes the pending downgrade so that the subscription will continue with its current plan.

Important Notes:

  • The downgrade must be pending (not yet executed) to be cancelled
  • Once cancelled, the subscription will remain on its current plan
  • An activity log entry is created when a downgrade is cancelled

Use Cases:

  • Allow customers to change their mind about a scheduled downgrade
  • Cancel downgrades when customers upgrade or renew
  • Administrative cancellation of pending plan changes

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

Path
contractIdinteger(int64)required

The subscription contract ID

Example: 12345
Query
api_keystring

API Key (Deprecated - Use Header X-API-Key instead)

Headers
X-API-Keystring
curl -i -X DELETE \
  'https://membership-admin.appstle.com/api/external/v2/subscription-contract-details/12345/pending-downgrade?api_key=string' \
  -H 'X-API-Key: string'

Responses

Pending downgrade cancelled successfully

Get subscription order fulfillment details

Request

Retrieves fulfillment information for the most recent order generated by a subscription contract. Shows shipping status, tracking numbers, and delivery progress.

Key Features:

  • Latest Order: Returns fulfillment data for the most recent subscription order
  • Tracking Info: Includes tracking numbers, URLs, and shipping carriers
  • Fulfillment Status: Shows whether items are unfulfilled, fulfilled, or partially fulfilled
  • Multi-Fulfillment: Handles orders split across multiple shipments

Returned Fulfillment Data:

  • Order Info: Order name/number, creation date, financial status
  • Fulfillment Status: FULFILLED, PARTIAL, UNFULFILLED, etc.
  • Fulfillments List: Array of all fulfillments for the order
  • Tracking Numbers: Tracking codes for each fulfillment
  • Tracking URLs: Direct links to carrier tracking pages
  • Shipping Carrier: Carrier name (USPS, FedEx, UPS, etc.)
  • Fulfillment Date: When each shipment was fulfilled
  • Line Items: Which products/variants are in each shipment
  • Delivery Address: Where the order is being shipped

Common Use Cases:

  • Order Tracking: Show customers where their subscription delivery is
  • Customer Portal: Display "Track Your Order" links
  • Shipping Updates: Check fulfillment status for recent orders
  • Support: Help customers track delayed or missing shipments
  • Notifications: Trigger custom shipping notifications
  • Analytics: Track fulfillment performance metrics

Response Structure: Returns an Order object containing:

  • Basic order information
  • Array of fulfillments with tracking details
  • Line items per fulfillment
  • Shipping and delivery information

Note: This returns data for the MOST RECENT order only. For historical fulfillment data, use order history endpoints.

Parameters:

  • contractId (required, path): The subscription contract ID

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

Path
contractIdinteger(int64)required

Subscription contract ID

Example: 12345
Query
api_keystring

API Key (Deprecated - Use Header X-API-Key instead)

Headers
X-API-Keystring
curl -i -X GET \
  'https://membership-admin.appstle.com/api/external/v2/subscription-contract-details/subscription-fulfillments/12345?api_key=string' \
  -H 'X-API-Key: string'

Responses

Fulfillment details retrieved successfully

Bodyapplication/json
get__typenamestring
idstring
fulfillmentOrdersobject(FulfillmentOrders)
Response
application/json
{
  "get__typename": "string",
  "id": "string",
  "fulfillmentOrders": {
    "get__typename": "string",
    "nodes": [ … ],
    "pageInfo": { … }
  }
}

Bundle Settings

APIs for managing subscription bundle configuration settings including bundle behavior, pricing rules, and display options

Operations

Customer Payment Methods

APIs for managing customer payment methods, payment tokens, and payment method retrieval for subscriptions

Operations

Product Swap Rules

APIs for retrieving product swap/substitution options allowing members to exchange subscription items based on configured swap rules and variant groups

Operations

Subscription Contract Management

Operations

Subscription Billing

Operations

Billing Attempts

Operations