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

# Catalog Stream Tracking

> Read enabled state and latest run coverage without starting provider work. Standard MCP manage_catalog_stream_tracking with action=status. Unchanged daily values reuse their saved versions; new dates and corrections are appended, with fresh coverage/provenance receipts for every run.



## OpenAPI

````yaml get /api/catalogs/{catalogId}/stream-tracking
openapi: 3.1.0
info:
  title: Recoup API - Releases
  description: >-
    API documentation for the Recoup platform - an AI agent platform for the
    music industry
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.recoupable.dev
security: []
paths:
  /api/catalogs/{catalogId}/stream-tracking:
    get:
      summary: Inspect daily catalog tracking
      description: >-
        Read enabled state and latest run coverage without starting provider
        work. Standard MCP manage_catalog_stream_tracking with action=status.
        Unchanged daily values reuse their saved versions; new dates and
        corrections are appended, with fresh coverage/provenance receipts for
        every run.
      parameters:
        - name: catalogId
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            Catalog owned by the authenticated account or an organization it
            currently belongs to.
      responses:
        '200':
          description: Collection status
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                  catalog_id:
                    type: string
                    format: uuid
                  provider:
                    type: string
                    enum:
                      - luminate
                  platform:
                    type: string
                    enum:
                      - all_dsps
                  metric:
                    type: string
                    enum:
                      - daily_streams
                  latest_run:
                    $ref: '#/components/schemas/CatalogStreamRun'
                    description: >-
                      Run status, per-ISRC coverage, errors, window and
                      completion timestamp.
                  territory:
                    type: string
                    enum:
                      - worldwide
                  tracking:
                    type:
                      - object
                      - 'null'
                    properties:
                      catalog_id:
                        type: string
                        format: uuid
                      owner_id:
                        type: string
                        format: uuid
                      enabled:
                        type: boolean
                      revision:
                        type: string
                        format: uuid
                      updated_at:
                        type: string
                        format: date-time
                  collection:
                    type:
                      - object
                      - 'null'
                    properties:
                      state:
                        type: string
                        enum:
                          - started
                          - already_claimed_or_disabled
                      run_id:
                        type:
                          - string
                          - 'null'
                        format: uuid
                      workflow_run_id:
                        type: string
        '400':
          description: Invalid input
        '401':
          description: Authentication required
        '404':
          description: Catalog not accessible
        '503':
          description: Storage, configuration or dispatch unavailable
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    CatalogStreamRun:
      type:
        - object
        - 'null'
      properties:
        id:
          type: string
          format: uuid
        catalog_id:
          type: string
          format: uuid
        revision:
          type: string
          format: uuid
        scheduled_day:
          type: string
          format: date
        since:
          type: string
          format: date
        until:
          type: string
          format: date
        status:
          type: string
          enum:
            - queued
            - running
            - complete
            - partial
            - failed
            - cancelled
        coverage:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/CatalogStreamReceipt'
        error:
          type:
            - string
            - 'null'
        created_at:
          type: string
          format: date-time
        finished_at:
          type:
            - string
            - 'null'
          format: date-time
    CatalogStreamReceipt:
      type:
        - object
        - 'null'
      properties:
        state:
          type: string
          enum:
            - complete
            - partial
            - unavailable
            - failed
        observed_days:
          type: integer
          minimum: 0
          maximum: 62
        retrieved_at:
          type:
            - string
            - 'null'
          format: date-time
        source_hash:
          type:
            - string
            - 'null'
        provider_recording_id:
          type:
            - string
            - 'null'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: Your Recoup API key. [Learn more](/quickstart#api-keys).
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.