> ## Documentation Index > Fetch the complete documentation index at: https://developers.appstle.com/llms.txt > Use this file to discover all available pages before exploring further. # Get upcoming orders > Retrieves upcoming/scheduled orders for a subscription contract from the customer portal. ## OpenAPI ````yaml /memberships/storefront-api-swagger.json get /memberships/cp/api/subscription-billing-attempts/top-orders openapi: 3.0.1 info: description: >- Comprehensive API documentation for the customer-facing membership portal. These APIs enable customers to manage their memberships, update billing information, modify delivery schedules, and access their account details through your storefront. **Important**: These APIs must be called from your shop's domain (e.g., https://www.myshop.com/apps/memberships/cp/api/**) and require customer authentication. Unauthenticated requests will return a 401 Unauthorized error. title: Storefront APIs version: 0.0.1 servers: - url: https://www.myshop.com/apps security: [] tags: - description: >- APIs for managing Shopify delivery profiles, shipping rates, zones, and free shipping configuration for subscription memberships name: Shipping & Delivery Profiles - description: >- APIs for managing shop-level membership settings, configuration, email domains, webhooks, and general store information name: Shop Settings - description: >- APIs for integrating loyalty programs with memberships including customer points lookup, earn options, redeem options, and point redemption name: Loyalty Integration - description: >- APIs for retrieving historical discount code usage and redemption information for membership contracts name: Customer Discount History - description: >- APIs for managing membership cancellation flow settings including retention offers, survey questions, and cancel confirmation screens name: Cancellation Flow Configuration - description: >- APIs for managing membership billing attempts, recurring orders, payment retries, order history, and order skipping name: Billing & Orders - description: >- APIs for managing one-time product additions to upcoming subscription orders, including adding, retrieving, and removing one-off items name: One-Time Add-Ons - description: >- APIs for managing membership/subscription plan groups, including creating plans, configuring discounts, billing intervals, and assigning products to plans name: Membership Plans - description: >- APIs for managing customer retention activities including cancellation feedback, retention action tracking, and activity export name: Customer Retention - description: >- APIs for retrieving custom CSS styles applied to subscription widgets and customer portal for theme customization name: Custom CSS Styling - description: >- APIs for managing customer portal settings including UI customization, text labels, feature toggles, and branding options for the member self-service portal name: Customer Portal Configuration - description: >- APIs for managing membership/subscription contracts including creation, updates, status changes, line items, discounts, and billing operations name: Membership Contracts - description: >- APIs for retrieving product catalog, variants, pricing, and inventory information for subscription memberships name: Product & Inventory Data - description: >- APIs for retrieving product swap/substitution options allowing members to exchange subscription items based on configured swap rules and variant groups name: Product Swap Rules - description: APIs for managing subscription product bundles and bundle configurations. name: Product Bundles - description: APIs for managing payment methods and billing information. name: Customer Payment Methods paths: /memberships/cp/api/subscription-billing-attempts/top-orders: get: tags: - Billing & Orders summary: Get upcoming orders description: >- Retrieves upcoming/scheduled orders for a subscription contract from the customer portal. operationId: getTopOrdersForCP parameters: - in: query name: contractId required: false schema: format: int64 type: integer responses: '200': content: '*/*': schema: items: $ref: '#/components/schemas/SubscriptionBillingAttemptDTO' type: array description: OK components: schemas: SubscriptionBillingAttemptDTO: properties: applyUsageCharge: type: boolean attemptCount: description: Number of billing retry attempts example: 1 format: int32 type: integer attemptTime: format: date-time type: string billingAttemptId: description: Shopify billing attempt ID type: string billingAttemptResponseMessage: type: string billingDate: description: Scheduled billing date for this attempt format: date-time type: string contractId: description: Associated subscription contract ID example: 67890 format: int64 type: integer graphOrderId: type: string id: description: Unique identifier of the billing attempt record example: 12345 format: int64 type: integer orderAmount: description: Total order amount example: 29.99 format: double type: number orderAmountUSD: format: double type: number orderId: description: Shopify order ID if billing was successful format: int64 type: integer orderName: description: Shopify order name/number example: '#1001' type: string orderNote: description: Order note or special instructions type: string progressAttemptCount: format: int32 type: integer recurringChargeId: format: int64 type: integer retryingNeeded: type: boolean securityChallengeSentStatus: enum: - SENT - UNSENT - FAILED - EMAIL_SETTINGS_DISABLED - CONTRACT_CANCELLED type: string shop: description: Shop domain identifier example: my-store.myshopify.com type: string status: description: Current status of the billing attempt enum: - SUCCESS - FAILURE - REQUESTING - PROGRESS - QUEUED - SKIPPED - SOCIAL_CONNECTION_NULL - CONTRACT_CANCELLED - CONTRACT_ENDED - CONTRACT_PAUSED - AUTO_CHARGE_DISABLED - SKIPPED_DUNNING_MGMT - SECURITY_CHALLENGE - SHOPIFY_EXCEPTION type: string transactionFailedEmailSentStatus: enum: - SENT - UNSENT - FAILED - EMAIL_SETTINGS_DISABLED - CUSTOMER_PAYMENT_EMPTY - CONTRACT_CANCELLED type: string transactionFailedSmsSentStatus: enum: - SENT - UNSENT - FAILED - SMS_SETTINGS_DISABLED - CUSTOMER_PAYMENT_EMPTY - CONTRACT_CANCELLED - PHONE_NUMBER_EMPTY type: string transactionRate: format: double type: number upcomingOrderEmailSentStatus: enum: - SENT - UNSENT - FAILED - EMAIL_SETTINGS_DISABLED - CUSTOMER_PAYMENT_EMPTY - CONTRACT_CANCELLED - STOP_FROM_CONTRACT - CONTRACT_PAUSED type: string upcomingOrderSmsSentStatus: enum: - SENT - UNSENT - FAILED - SMS_SETTINGS_DISABLED - CUSTOMER_PAYMENT_EMPTY - CONTRACT_CANCELLED - STOP_FROM_CONTRACT - CONTRACT_PAUSED - PHONE_NUMBER_EMPTY type: string upgradeDowngradeBilling: type: boolean usageChargeStatus: enum: - SUCCESS - FAILED - TO_BE_TRIED type: string variantList: items: $ref: '#/components/schemas/VariantQuantity' type: array required: - retryingNeeded - shop type: object VariantQuantity: properties: image: type: string productId: type: string productTitle: type: string quantity: format: int32 type: integer sellingPlanId: type: string title: type: string variantId: format: int64 type: integer type: object ````