> ## 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.

# Daily Catalog Streams

> Saved Luminate worldwide aggregate calendar-day streams across reporting DSPs, not Spotify-only or royalty statements. Includes current catalog recordings even when unmeasured, latest collection status, per-recording daily rows/retrieval time, missing dates, equal-period totals and growth. Newer source corrections win; historical versions remain stored. Missing days and changed provider recording identity suppress comparisons. Zero baseline yields null percentage. Page through pagination.has_more; summary_scope is page. Reads make no provider requests. Standard MCP: get_catalog_streams. Requires API and database feature release; unavailable to delegated OAuth. 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}/streams
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}/streams:
    get:
      summary: Read daily catalog streams
      description: >-
        Saved Luminate worldwide aggregate calendar-day streams across reporting
        DSPs, not Spotify-only or royalty statements. Includes current catalog
        recordings even when unmeasured, latest collection status, per-recording
        daily rows/retrieval time, missing dates, equal-period totals and
        growth. Newer source corrections win; historical versions remain stored.
        Missing days and changed provider recording identity suppress
        comparisons. Zero baseline yields null percentage. Page through
        pagination.has_more; summary_scope is page. Reads make no provider
        requests. Standard MCP: get_catalog_streams. Requires API and database
        feature release; unavailable to delegated OAuth. 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.
        - name: since
          in: query
          required: true
          schema:
            type: string
            format: date
          description: >-
            Current period start, inclusive. Previous period has the same length
            and immediately precedes it.
        - name: days
          in: query
          required: true
          schema:
            type: integer
            minimum: 1
            maximum: 31
          description: >-
            Equal period length; end dates are exclusive. Missing days suppress
            growth.
        - name: page
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 1000000
            default: 1
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 25
            default: 25
      responses:
        '200':
          description: Saved history and comparisons
          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
                  semantics:
                    type: string
                  source_updated_at:
                    type: 'null'
                  periods:
                    type: object
                    properties:
                      previous:
                        type: object
                        properties:
                          start:
                            type: string
                            format: date
                          end_exclusive:
                            type: string
                            format: date
                      current:
                        type: object
                        properties:
                          start:
                            type: string
                            format: date
                          end_exclusive:
                            type: string
                            format: date
                      days:
                        type: integer
                      timezone:
                        type: string
                        enum:
                          - UTC
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      limit:
                        type: integer
                      total_count:
                        type: integer
                      has_more:
                        type: boolean
                  summary_scope:
                    type: string
                    enum:
                      - page
                  recordings:
                    type: array
                    items:
                      type: object
                      properties:
                        isrc:
                          type: string
                        name:
                          type:
                            - string
                            - 'null'
                        provider_recording_id:
                          type:
                            - string
                            - 'null'
                        retrieved_at:
                          type:
                            - string
                            - 'null'
                          format: date-time
                        days:
                          type: array
                          items:
                            type: object
                            properties:
                              date:
                                type: string
                                format: date
                              streams:
                                type:
                                  - integer
                                  - 'null'
                            required:
                              - date
                              - streams
                        state:
                          type: string
                          enum:
                            - comparable
                            - incomplete
                            - unfinished_period
                            - invalid_observation
                        missing_days:
                          type: array
                          items:
                            type: string
                            format: date
                        previous_streams:
                          type:
                            - integer
                            - 'null'
                        current_streams:
                          type:
                            - integer
                            - 'null'
                        absolute_growth:
                          type:
                            - integer
                            - 'null'
                        percentage_growth:
                          type:
                            - number
                            - 'null'
                        zero_baseline:
                          type: boolean
                        latest_attempt:
                          $ref: '#/components/schemas/CatalogStreamReceipt'
                          description: >-
                            Fresh recording-level receipt for the latest run,
                            including state, observed_days, retrieved_at,
                            source_hash and provider_recording_id. Observation
                            retrieved_at is when its retained version was
                            introduced.
        '400':
          description: Invalid input or incomplete calendar period
        '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.