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

# Get Catalog Valuations

> Get the persisted valuation history for a catalog, latest first. A row is written each time a valuation band is computed for the whole catalog (valuation runs and measurement reads persist at most one row per catalog per day). Use limit=1 for the current value. History is what makes week-over-week deltas possible.



## OpenAPI

````yaml get /api/catalogs/{catalogId}/valuations
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}/valuations:
    get:
      description: >-
        Get the persisted valuation history for a catalog, latest first. A row
        is written each time a valuation band is computed for the whole catalog
        (valuation runs and measurement reads persist at most one row per
        catalog per day). Use limit=1 for the current value. History is what
        makes week-over-week deltas possible.
      parameters:
        - name: catalogId
          in: path
          description: >-
            The unique identifier of the catalog. The catalog must belong to the
            authenticated account. Malformed (non-uuid) values are rejected with
            400.
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          description: >-
            Maximum number of valuation rows to return, latest first (default
            30, max 100). limit=1 returns the current value. Invalid values are
            rejected with 400.
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 30
      responses:
        '200':
          description: >-
            The catalog's persisted valuation rows, latest first. Empty when no
            valuation has been persisted yet.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CatalogValuationsResponse'
        '400':
          description: Malformed catalogId or limit
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid credentials
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Catalog not found or not owned by the authenticated account
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    CatalogValuationsResponse:
      type: object
      required:
        - status
        - valuations
      properties:
        status:
          type: string
          example: success
        valuations:
          type: array
          description: Persisted valuation rows, latest first.
          items:
            type: object
            required:
              - low
              - mid
              - high
              - measured_song_count
              - total_streams
              - measured_at
            properties:
              low:
                type: number
                description: Low end of the estimated catalog value band, USD.
              mid:
                type: number
                description: Midpoint of the estimated catalog value band, USD.
              high:
                type: number
                description: High end of the estimated catalog value band, USD.
              measured_song_count:
                type: integer
                description: >-
                  Songs measured in the capture this valuation was computed
                  from.
              total_streams:
                type: integer
                description: Whole-catalog lifetime stream total at measurement time.
              measured_at:
                type: string
                format: date-time
                description: When the underlying measurement was taken.
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  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

````