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

# List schedules



## OpenAPI

````yaml /openapi.json get /v1/reporters/{reporter_id}/schedules
openapi: 3.1.0
info:
  title: clipping API
  version: 1.0.0
  description: >-
    The clipping API — one API under /v1, two credentials:


    - **API key** (`Authorization: Bearer ck_live_…`): for integrators. Each
    call draws a flat platform fee from the key's account balance, plus the real
    cost of external calls (pass-through). No balance → HTTP 402. Create a key
    at https://clipping.cc/account.

    - **Session JWT** (`Authorization: Bearer <jwt>` from /v1/auth/login): used
    by the web app. No platform fee (only external-call pass-through).


    Either credential hits the same endpoints. Routes marked *admin only*
    require an admin role.
servers:
  - url: https://api.clipping.cc
    description: production
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: auth
    description: session auth, profile and API key management
  - name: accounts
    description: balance, ledger, deposits and withdrawals
  - name: items
    description: monitored sources (channels, videos, etc.)
  - name: collections
    description: collections of monitored sources
  - name: videos
    description: catalogued videos
  - name: tools
    description: tool catalog, transcripts and documents
  - name: search
    description: semantic search and tag cloud over your library
  - name: discover
    description: public catalog (collections, reporters, users)
  - name: reporters
    description: 'reporters: CRUD, clone, collections, subscriptions, run'
  - name: workflows
    description: a reporter's workflows and their steps
  - name: schedules
    description: a reporter's schedules and runs
  - name: executions
    description: workflow execution tracking
  - name: events
    description: the user's event feed
  - name: logs
    description: 'external call audit: OpenAI, YouTube, transcriber'
  - name: realtime
    description: WebSocket hub for live notifications
  - name: admin
    description: 'admin only: other users'' accounts and economy stats'
  - name: treasury
    description: 'admin only: platform cash desk'
paths:
  /v1/reporters/{reporter_id}/schedules:
    get:
      tags:
        - schedules
      summary: List schedules
      operationId: listSchedules
      parameters:
        - name: reporter_id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Schedules with collection ids.
          content:
            application/json:
              schema:
                type: object
                properties:
                  schedules:
                    type: array
                    items:
                      $ref: '#/components/schemas/Schedule'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    Schedule:
      type: object
      additionalProperties: true
      properties:
        schedule_id:
          type: string
        reporter_id:
          type: string
        name:
          type: string
        enabled:
          type: boolean
        interval_hours:
          type:
            - integer
            - 'null'
        workflow_id:
          type: string
        collection_ids:
          type: array
          items:
            type: string
    Error:
      type: object
      properties:
        erro:
          type: string
      required:
        - erro
  responses:
    Unauthorized:
      description: Missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Resource not found or no access.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: bearer
      bearerFormat: ck_live_…
      description: 'API key: Authorization: Bearer ck_live_…'
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Session JWT from /v1/auth/login: Authorization: Bearer <jwt>'

````