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

# List claim schedules

> Returns a paginated list of claim schedules

```bash OAuth Scope theme={null}
rewards:read_claims_schedule
```


## OpenAPI

````yaml get /rewards/claim-schedules
openapi: 3.0.0
info:
  title: Paxos Rewards API
  version: v2-preview
servers: []
security: []
paths:
  /rewards/claim-schedules:
    get:
      tags:
        - Claims
      summary: List claim schedules
      description: Returns a paginated list of claim schedules.
      operationId: ListClaimSchedules
      parameters:
        - name: payout_group_id
          description: Optionally filter by payout group.
          in: query
          required: false
          schema:
            type: string
        - name: limit
          description: Number of results to return. Defaults to 100. Maximum 1000.
          in: query
          required: false
          schema:
            type: integer
            format: int32
        - name: page_cursor
          description: Cursor for getting the next page of results.
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: A successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListClaimSchedulesResponse'
      security:
        - OAuth2:
            - rewards:read_claims_schedule
components:
  schemas:
    ListClaimSchedulesResponse:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/ClaimSchedule'
          description: Claim schedules in this page of results.
        next_page_cursor:
          type: string
          description: >-
            Token to retrieve the next page of results, or empty if there are no
            more results.
    ClaimSchedule:
      type: object
      properties:
        id:
          type: string
        payout_group_id:
          type: string
        schedule_type:
          $ref: '#/components/schemas/ScheduleType'
        next_run_at:
          type: string
          format: date-time
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time
    ScheduleType:
      type: string
      enum:
        - DAILY
  securitySchemes:
    OAuth2:
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://oauth.paxos.com/oauth2/token
          scopes:
            rewards:read_monitoring_address: Read reward addresses
            rewards:write_monitoring_address: Create and manage reward addresses
            rewards:read_claims_schedule: Read claim schedules
            rewards:write_claims_schedule: Create and manage claim schedules
            rewards:read_claims: Read claims
            rewards:read_payout_groups: Read payout groups
            rewards:write_payout_groups: Create and manage payout groups
            rewards:read_rewards_details: Read reward details

````