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

# List Music Generations

> The calling account's music generations, newest first. Scope follows the standard account override: with no `account_id` you get your own personal and organization generations; pass `account_id` to read another account you can access. `logs` is omitted here to keep the response small, and comes back on the single-generation read.



## OpenAPI

````yaml api-reference/openapi/content.json GET /api/music
openapi: 3.1.0
info:
  title: Recoup API - Content
  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/music:
    get:
      summary: List music generations
      description: >-
        The calling account's music generations, newest first. Scope follows the
        standard account override: with no `account_id` you get your own
        personal and organization generations; pass `account_id` to read another
        account you can access. `logs` is omitted here to keep the response
        small, and comes back on the single-generation read.
      parameters:
        - name: account_id
          in: query
          required: false
          schema:
            type: string
            format: uuid
          description: >-
            Optional. Read another account you can access. Defaults to the
            calling account.
        - name: status
          in: query
          required: false
          schema:
            type: string
            enum:
              - pending
              - processing
              - completed
              - failed
          description: Optional. Return only generations in this state.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 50
            default: 20
          description: Optional. Maximum generations to return, newest first.
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
          description: Optional. Number of generations to skip, for paging.
      responses:
        '200':
          description: Generations in the requested context, newest first.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationListResponse'
        '400':
          description: Invalid query parameter.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '401':
          description: Unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '403':
          description: Access denied to the specified `account_id`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MusicGenerationErrorResponse'
      security:
        - apiKeyAuth: []
        - bearerAuth: []
components:
  schemas:
    MusicGenerationListResponse:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
          description: Status of the request
        generations:
          type: array
          description: Generations, newest first. Empty when the context has none.
          items:
            $ref: '#/components/schemas/MusicGeneration'
    MusicGenerationErrorResponse:
      type: object
      required:
        - status
        - error
      properties:
        status:
          type: string
          enum:
            - error
          description: Always `error`
        missing_fields:
          type: array
          description: >-
            JSON path segments to the first field that failed validation, e.g.
            `["lyrics"]`
          items:
            oneOf:
              - type: string
              - type: integer
        error:
          type: string
          description: Human-readable error message
    MusicGeneration:
      type: object
      description: One music generation.
      properties:
        id:
          type: string
          format: uuid
          description: >-
            The generation's id. Poll [Get Music
            Generation](/api-reference/music/get) with this.
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
          description: >-
            Lifecycle phase. `pending` until the workflow picks it up,
            `processing` while fal is rendering, then `completed` or `failed`.
        prompt:
          type: string
          description: The music description the song was generated from.
        lyrics:
          type: string
          description: The lyrics the song was generated from.
        title:
          type: string
          nullable: true
          description: Display title. Null until the generation completes.
        model:
          type: string
          description: The generating model.
          example: minimax/music-3
        duration_seconds:
          type: number
          nullable: true
          description: >-
            Actual length of the generated audio. Null until completed; may be
            shorter than requested.
        seed:
          type: integer
          nullable: true
          description: >-
            Seed actually used. Null until completed. Pass it back to reproduce
            a generation.
        num_inference_steps:
          type: integer
          description: Flow-matching steps used.
        guidance_scale:
          type: number
          description: Guidance scale used.
        audio_url:
          type: string
          nullable: true
          description: Playable audio URL. Null until the generation completes.
        mime_type:
          type: string
          nullable: true
          description: Media type of the audio.
          example: audio/wav
        file_size_bytes:
          type: integer
          nullable: true
          description: Size of the generated audio in bytes.
        organization_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            Organization the generation belongs to. Null for a personal
            generation.
        error_message:
          type: string
          nullable: true
          description: Why the generation failed. Null unless `status` is `failed`.
        created_at:
          type: string
          format: date-time
          description: When the generation was created.
        updated_at:
          type: string
          format: date-time
          description: When the generation last changed.
  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

````