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

# List mandate debit schedules

> Retrieves the paginated list of `MandateDebitSchedule` entries for a customer across all mandates. Each entry represents a queued, executed, retried, or cancelled mandate-based debit attempt. Use optional `mandate_id` and `status` query parameters to narrow results.



## OpenAPI

````yaml https://openapi.commercengine.io/ce-admin.json get /customers/{customer_id}/mandate-debit-schedules
openapi: 3.1.0
info:
  title: CE Admin APIs
  version: '1.0'
  summary: Comprehensive admin interface for managing your e-commerce platform
  description: >-
    Complete administrative API suite for Commerce Engine, providing powerful
    tools to manage products, orders, customers, inventory, analytics, and
    system configuration. Designed for administrators and backend integrations
    requiring full platform control.
  license:
    name: All Rights Reserved
    url: https://www.commercengine.io/contact-us
  contact:
    email: support@commercengine.io
    url: https://www.commercengine.io/contact-us
    name: Support
servers:
  - url: https://staging.api.commercengine.io/api/v1/{store_id}/admin
    description: Staging Server
    variables:
      store_id:
        default: store_id
        description: Store ID
  - url: https://prod.api.commercengine.io/api/v1/{store_id}/admin
    description: Prod Server
    variables:
      store_id:
        default: store_id
        description: Store ID
security:
  - Authorization: []
tags:
  - name: Analytics
    description: Analytics
  - name: Catalog
    description: Catalog
  - name: Coupons & promotions
    description: Coupons & promotions
  - name: Customers
    description: Customers
  - name: Filter Options
    description: Filter Options
  - name: Inventories
    description: Inventories
  - name: Marketplace
    description: Marketplace
  - name: Marketplace Catalog
    description: Marketplace Catalog
  - name: Media Gallery
    description: Media Gallery
  - name: Metrics
    description: Metrics
  - name: Orders
    description: Orders
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: POS
    description: POS
  - name: Segments
    description: Segments
  - name: Shipping
    description: Shipping
  - name: SSE
    description: SSE
  - name: Store
    description: Store
  - name: Webhooks
    description: Webhooks
paths:
  /customers/{customer_id}/mandate-debit-schedules:
    parameters:
      - name: customer_id
        in: path
        description: Customer Id
        required: true
        schema:
          type: string
    get:
      tags:
        - Customers
      summary: List mandate debit schedules
      description: >-
        Retrieves the paginated list of `MandateDebitSchedule` entries for a
        customer across all mandates. Each entry represents a queued, executed,
        retried, or cancelled mandate-based debit attempt. Use optional
        `mandate_id` and `status` query parameters to narrow results.
      operationId: list-customer-mandate-debit-schedules
      parameters:
        - $ref: '#/components/parameters/pageNumber'
        - $ref: '#/components/parameters/pageLimit'
        - name: mandate_id
          in: query
          description: Filter debit schedules to a specific `CustomerMandate` ID.
          required: false
          schema:
            type: string
        - name: status
          in: query
          description: Filter debit schedules by execution status.
          required: false
          schema:
            type: string
            enum:
              - scheduled
              - debit-requested
              - debit-success
              - debit-failed
              - cancelled
              - awaiting-retry
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - success
                  - content
                properties:
                  message:
                    type: string
                  success:
                    type: boolean
                  content:
                    properties:
                      debit_schedules:
                        type: array
                        items:
                          $ref: '#/components/schemas/MandateDebitSchedule'
                      pagination:
                        $ref: '#/components/schemas/Pagination'
                    required:
                      - debit_schedules
                    type: object
components:
  parameters:
    pageNumber:
      name: page
      in: query
      required: false
      schema:
        type: integer
        default: 1
        minimum: 1
      description: page number of pagination list
    pageLimit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        default: 25
        minimum: 1
      description: no of rows per page
  schemas:
    MandateDebitSchedule:
      title: MandateDebitSchedule
      type: object
      required:
        - id
        - mandate_id
        - order_id
        - amount
        - status
        - scheduled_at
        - retry_attempt
        - max_retries
        - created_at
        - modified_at
      properties:
        id:
          type: string
        mandate_id:
          description: ID of the parent `CustomerMandate`.
          type: string
        order_id:
          description: ID of the order that triggered this debit.
          type: string
        order_number:
          description: Order number of the order that triggered this debit.
          type:
            - string
            - 'null'
        amount:
          description: Amount to be debited from the customer for this scheduled execution.
          type: number
        status:
          type: string
          enum:
            - scheduled
            - debit-requested
            - debit-success
            - debit-failed
            - cancelled
            - awaiting-retry
        scheduled_at:
          description: >-
            Time at which the debit is queued to be executed against the mandate
            provider.
          type: string
          format: date-time
        picked_at:
          description: Time at which the worker picked the schedule for execution.
          type:
            - string
            - 'null'
          format: date-time
        executed_at:
          description: Time at which the debit was executed against the mandate provider.
          type:
            - string
            - 'null'
          format: date-time
        external_reference_id:
          description: Mandate provider reference returned for this debit.
          type:
            - string
            - 'null'
        gateway_order_id:
          description: Order ID submitted to the mandate provider for this debit.
          type:
            - string
            - 'null'
        retry_attempt:
          type: integer
        max_retries:
          type: integer
        next_retry_at:
          description: Time at which the next retry will be attempted.
          type:
            - string
            - 'null'
          format: date-time
        created_at:
          type: string
          format: date-time
        modified_at:
          type: string
          format: date-time
    Pagination:
      title: Pagination
      description: pagination metadata structure
      type: object
      properties:
        total_records:
          type: integer
        total_pages:
          type: integer
        previous_page:
          description: Previous page number
          type:
            - integer
            - 'null'
        limit:
          type: integer
          default: 25
        next_page:
          description: Next page number
          type:
            - integer
            - 'null'
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer

````