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

# List Scheduled Payments

> List scheduled (fixed-price) payments of the authenticated client



## OpenAPI

````yaml /openapi.json get /api/v1/external/reports/client/scheduled-payments/list
openapi: 3.0.0
info:
  title: goLance API
  version: 1.0.0
servers:
  - url: https://golance.com
security: []
paths:
  /api/v1/external/reports/client/scheduled-payments/list:
    get:
      tags:
        - Reports
      summary: List Scheduled Payments
      description: List scheduled (fixed-price) payments of the authenticated client
      parameters:
        - schema:
            type: array
            items:
              type: string
            example:
              - 6137109712adad9757ab0e35
          required: false
          name: teamIds
          in: query
        - schema:
            type: string
            description: Start date in YYYY-MM-DD format
            example: '2023-01-01'
          required: true
          name: fromDate
          in: query
        - schema:
            type: string
            description: End date in YYYY-MM-DD format
            example: '2023-01-31'
          required: true
          name: toDate
          in: query
        - schema:
            type: array
            items:
              type: string
            example:
              - 6137109712adad9757ab0e35
          required: false
          name: contractorIds
          in: query
        - schema:
            type: array
            items:
              type: string
              enum:
                - upcoming
                - processing
                - failed
                - paid
                - deleted
            example:
              - upcoming
              - paid
          required: false
          name: scheduledPaymentStatuses
          in: query
        - schema:
            type: string
            enum:
              - asc
              - desc
            default: desc
          required: false
          name: sortOrder
          in: query
        - schema:
            type: string
            enum:
              - scheduledPaymentOn
              - date
              - budget
              - paidAmount
              - scheduledPaymentStatus
              - contract
              - contractor
            default: scheduledPaymentOn
          required: false
          name: sortField
          in: query
        - schema:
            type: number
            minimum: 1
            default: 1
          required: false
          name: page
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 100
            default: 10
          required: false
          name: itemsPerPage
          in: query
      responses:
        '200':
          description: Scheduled payments list response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        name:
                          type: string
                        amount:
                          type: number
                        paidAmount:
                          type: number
                        status:
                          type: string
                          enum:
                            - upcoming
                            - processing
                            - failed
                            - paid
                            - deleted
                        scheduledPaymentOn:
                          type: string
                          description: Scheduled payment date (ISO 8601)
                        contract:
                          type: object
                          properties:
                            _id:
                              type: string
                            title:
                              type: string
                            contractor:
                              type: object
                              properties:
                                _id:
                                  type: string
                                firstName:
                                  type: string
                                lastName:
                                  type: string
                              required:
                                - _id
                                - firstName
                                - lastName
                            employer:
                              type: object
                              properties:
                                _id:
                                  type: string
                                firstName:
                                  type: string
                                lastName:
                                  type: string
                              required:
                                - _id
                                - firstName
                                - lastName
                            team:
                              type: object
                              nullable: true
                              properties:
                                _id:
                                  type: string
                                name:
                                  type: string
                              required:
                                - _id
                                - name
                          required:
                            - _id
                            - title
                            - contractor
                            - employer
                            - team
                      required:
                        - _id
                        - name
                        - amount
                        - paidAmount
                        - status
                        - scheduledPaymentOn
                        - contract
                  pagination:
                    type: object
                    properties:
                      currentPage:
                        type: number
                      itemsPerPage:
                        type: number
                      pagesCount:
                        type: number
                      totalCount:
                        type: number
                    required:
                      - currentPage
                      - itemsPerPage
                      - pagesCount
                      - totalCount
                  statistics:
                    type: object
                    properties:
                      contractsCount:
                        type: number
                      scheduledPaymentsCount:
                        type: number
                      paidScheduledPaymentsCount:
                        type: number
                      totalScheduledPaymentsPaidAmount:
                        type: number
                    required:
                      - contractsCount
                      - scheduledPaymentsCount
                      - paidScheduledPaymentsCount
                      - totalScheduledPaymentsPaidAmount
                required:
                  - results
                  - pagination
                  - statistics
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````