> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cocartapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# My Account - Get Subscriptions

> Retrieve customer subscription list with pagination

<Warning>
  This endpoint is currently shown as a preview of what's currently in development and is subject to change.
</Warning>

<Info>
  This endpoint supports only the official [WooCommerce Subscriptions](https://woocommerce.com/products/woocommerce-subscriptions/) extension.
</Info>


## OpenAPI

````yaml api-reference/pre-release/openapi-spec-preview.yaml get /my-account/subscriptions
openapi: 3.0.3
info:
  title: CoCart Preview API
  description: >
    CoCart Preview provides enhanced REST API endpoints for WooCommerce headless
    e-commerce solutions.

    This API extends CoCart with additional functionality for checkout, customer
    account management, and order handling.


    ## Authentication


    The API supports multiple authentication methods:

    - **Cart Key**: For guest customers, pass the cart key via `Cart-Key` header
    or `cart_key` parameter

    - **Basic Auth**: For registered customers using username/password

    - **JWT**: For registered customers using JWT tokens (requires JWT plugin)

    - **Session**: For logged-in WordPress users


    ## Base URL


    All API endpoints are prefixed with `/wp-json/cocart/preview/`


    ## Response Format


    All responses follow the CoCart standard format with consistent error
    handling and data structure.
  termsOfService: http://cocartapi.com/terms-of-conditions-polar/
  contact:
    email: support@cocartapi.com
  license:
    name: GNU General Public License v3.0
    url: http://www.gnu.org/licenses/gpl-3.0.html
  version: 0.0.1
servers:
  - url: '{protocol}://{host}/wp-json/cocart/preview'
    description: API Preview
    variables:
      protocol:
        enum:
          - http
          - https
        default: https
      host:
        default: example-store.com
        description: Your store domain
security: []
tags:
  - name: Checkout
    description: Complete checkout process including payment and order creation
  - name: My Account
    description: Customer account information and profile management
  - name: My Orders
    description: Customer order history and details
  - name: My Downloads
    description: Customer digital downloads
  - name: My Subscriptions
    description: Customer subscription management
externalDocs:
  description: Find out more about CoCart API
  url: https://docs.cocartapi.com
paths:
  /my-account/subscriptions:
    get:
      tags:
        - My Subscriptions
      summary: Get customer subscriptions
      description: Retrieve customer subscription list with pagination
      operationId: getMySubscriptions
      parameters:
        - name: page
          in: query
          description: The pagination of subscriptions to return
          required: false
          schema:
            type: integer
            default: 1
        - name: per_page
          in: query
          description: Limit of subscriptions to return per page
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 10
        - name: order
          in: query
          description: Order sort attribute ascending or descending
          required: false
          schema:
            type: string
            enum:
              - ASC
              - DESC
            default: DESC
      responses:
        '200':
          description: Subscriptions retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CustomerSubscriptions'
              examples:
                subscriptions:
                  $ref: '#/components/examples/CustomerSubscriptionsExample'
        '403':
          description: Forbidden - user must be logged in
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - basicAuth: []
        - bearerAuth: []
components:
  schemas:
    CustomerSubscriptions:
      type: object
      properties:
        subscriptions:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/SubscriptionSummary'
          description: Object with subscription IDs as keys
          example:
            '789':
              order_id: 456
              subscription_number: '#789'
              subscription_status: Active
              next_payment: January 15, 2025
              subscription_total: $29.99
              is_manual: false
        pagination:
          $ref: '#/components/schemas/Pagination'
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Error code identifier
        message:
          type: string
          description: Human-readable error message
        data:
          type: object
          description: Additional error data
          properties:
            status:
              type: integer
              description: HTTP status code
    SubscriptionSummary:
      type: object
      properties:
        order_id:
          type: integer
          description: Parent order ID
          example: 456
        subscription_number:
          type: string
          description: Subscription number with hash prefix
          example: '#789'
        subscription_status:
          type: string
          description: Subscription status name
          example: Active
        next_payment:
          type: string
          description: Next payment date formatted for display
          example: January 15, 2025
        subscription_total:
          type: string
          description: Subscription total amount formatted
          example: $29.99
        is_manual:
          type: boolean
          description: Whether subscription requires manual renewal
          example: false
    Pagination:
      type: object
      properties:
        previous:
          type: string
          format: uri
          description: Previous page URL
        next:
          type: string
          format: uri
          description: Next page URL
  examples:
    CustomerSubscriptionsExample:
      value:
        subscriptions:
          '123':
            order_id: 456
            subscription_number: '#123'
            subscription_status: Active
            next_payment: January 15, 2025
            subscription_total: $29.99
            is_manual: false
          '124':
            order_id: 457
            subscription_number: '#124'
            subscription_status: On hold
            next_payment: N/A
            subscription_total: $19.99
            is_manual: false
        pagination:
          previous: null
          next: null
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: WordPress username and password
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer authentication with JWT token
      bearerFormat: JWT

````