> ## Documentation Index > Fetch the complete documentation index at: https://docs.rawugc.com/llms.txt > Use this file to discover all available pages before exploring further. # List music tracks > List all music generation tasks for the authenticated user. Supports filtering by status and pagination. ## OpenAPI ````yaml /openapi.json get /music openapi: 3.0.0 info: title: RawUGC API version: 1.0.0 description: >- Generate AI videos, images, and music, and schedule social media posts programmatically. contact: name: API Support email: support@rawugc.com url: https://docs.rawugc.com license: name: Proprietary servers: - url: https://rawugc.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Tasks description: >- Deprecated. Use typed resource endpoints instead: GET /videos/{videoId}, GET /images/{imageId}, GET /music/{musicId}. - name: Image Generation description: >- Generate and edit AI images using Nano Banana models. Supports text-to-image generation (6 credits) and image-to-image editing (2 credits). - name: Video Generation description: Generate and manage AI videos using Sora 2, Kling, and Veo 3 models - name: Personas description: Manage target audience personas for content plans - name: Messaging description: Manage brand/positioning messaging for content plans - name: Products description: Manage products for video generation - name: Styles description: Manage video creative styles and templates - name: Characters description: List available AI characters for video generation - name: Video Editing description: Post-process videos with captions, overlays, and effects - name: Upload description: Upload video and image files for use in generation requests - name: Social Scheduling description: Schedule and manage social media posts to TikTok, Instagram, and YouTube - name: Social Accounts description: Manage connected social media accounts - name: Music Generation description: >- Generate AI music tracks using Suno models with customizable genre, mood, and style - name: Viral Library description: >- Browse and search analyzed TikTok videos across the platform. Includes AI-powered analysis with hooks, keyframes, performance insights, and semantic search via natural language queries. - name: Research description: >- Scrape TikTok videos, analyze any video, and generate content plans. Tools for competitive research and content strategy. paths: /music: get: tags: - Music Generation summary: List music tracks description: >- List all music generation tasks for the authenticated user. Supports filtering by status and pagination. operationId: listMusicTracks parameters: - name: status in: query required: false schema: type: string enum: - pending - processing - completed - failed description: Filter tracks by generation status - name: page in: query required: false schema: type: integer minimum: 1 default: 1 description: Page number - name: limit in: query required: false schema: type: integer default: 20 minimum: 1 maximum: 100 description: Number of tracks per page responses: '200': description: Paginated list of music tracks headers: X-RateLimit-Limit: schema: type: integer description: Maximum requests per window X-RateLimit-Remaining: schema: type: integer description: Remaining requests in current window X-RateLimit-Reset: schema: type: integer description: Unix timestamp when the rate limit resets content: application/json: schema: $ref: '#/components/schemas/PaginatedMusicResponse' '401': description: Authentication error content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ApiError' components: schemas: PaginatedMusicResponse: type: object properties: tracks: type: array items: $ref: '#/components/schemas/MusicResponse' description: Array of music generation tasks pagination: type: object properties: total: type: integer description: Total number of tracks matching filters page: type: integer description: Current page number pageSize: type: integer description: Number of tracks per page hasMore: type: boolean description: Whether more pages are available ApiError: type: object properties: type: type: string format: uri description: >- URI reference identifying the problem type (e.g., https://api.rawugc.com/errors/validation_error) title: type: string description: Short, human-readable summary of the problem status: type: number description: HTTP status code detail: type: string description: Human-readable explanation of the problem instance: type: string format: uri description: URI reference identifying this specific occurrence errors: type: object additionalProperties: type: array items: type: string description: Field-specific validation errors MusicResponse: type: object properties: musicId: type: string description: Unique music identifier (mus_xxx format) status: type: string enum: - pending - processing - completed - failed description: Current generation status model: type: string description: Suno model version used prompt: type: string description: Text prompt used for generation audioUrl: type: string format: uri description: >- URL to download the generated audio (available when status is 'completed') albumArtUrl: type: string format: uri description: URL for the generated album art image duration: type: number description: Track duration in seconds title: type: string description: Track title creditsUsed: type: number description: Credits deducted for this generation createdAt: type: number description: Timestamp when generation was initiated completedAt: type: number description: Timestamp when generation completed (if finished) failCode: type: string description: Error code if generation failed failMessage: type: string description: Error message if generation failed securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- Use your API key from the RawUGC dashboard. Include as: Authorization: Bearer YOUR_API_KEY ````