> ## 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 valid subscription contracts for a customer ## OpenAPI ````yaml /memberships/storefront-api-swagger.json get /memberships/cp/api/subscription-customers-detail/valid/{id} 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-customers-detail/valid/{id}: get: tags: - Membership Contracts summary: Get valid subscription contracts for a customer operationId: getValidSubscriptionCustomerDetails parameters: - in: path name: id required: true schema: type: string - in: query name: shop required: false schema: type: string responses: '200': content: '*/*': schema: items: $ref: '#/components/schemas/SubscriptionContractDetailsDTO' type: array description: OK components: schemas: SubscriptionContractDetailsDTO: properties: activatedOn: format: date-time type: string allowDeliveryPriceOverride: type: boolean autoCharge: type: boolean billingDateAfterTrial: format: date-time type: string billingPolicyInterval: type: string billingPolicyIntervalCount: format: int32 type: integer cancellationFeedback: type: string cancelledOn: format: date-time type: string contractAmount: format: double type: number contractAmountUSD: format: double type: number contractDetailsJSON: type: string createdAt: format: date-time type: string currencyCode: type: string customerEmail: type: string customerFirstName: type: string customerId: format: int64 type: integer customerLastName: type: string customerName: type: string deliveryPolicyInterval: type: string deliveryPolicyIntervalCount: format: int32 type: integer dunning: type: boolean emailBouncedOrFailed: type: boolean endsAt: format: date-time type: string graphCustomerId: type: string graphOrderId: type: string graphSubscriptionContractId: type: string id: format: int64 type: integer importedId: type: string maxCycles: format: int32 type: integer minCycles: format: int32 type: integer nextBillingDate: format: date-time type: string orderAmount: format: double type: number orderAmountUSD: format: double type: number orderId: format: int64 type: integer orderName: type: string orderNote: type: string orderNoteAttributes: type: string pausedBySecurityChallenge: type: boolean pausedFromActive: type: boolean pausedOn: format: date-time type: string phone: type: string shop: type: string startsAt: format: date-time type: string status: type: string stopUpComingOrderEmail: type: boolean subscriptionContractId: format: int64 type: integer subscriptionCreatedEmailSent: type: boolean subscriptionCreatedEmailSentStatus: enum: - SENT - UNSENT - FAILED - EMAIL_SETTINGS_DISABLED - CUSTOMER_PAYMENT_EMPTY - CONTRACT_PAUSED_STATUS type: string subscriptionCreatedSmsSentStatus: enum: - SENT - UNSENT - FAILED - SMS_SETTINGS_DISABLED - CUSTOMER_PAYMENT_EMPTY - CONTRACT_PAUSED_STATUS - PHONE_NUMBER_EMPTY type: string trialEndDate: format: date-time type: string upcomingSwapRule: type: string updatedAt: format: date-time type: string required: - shop type: object ````