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

> List your image generation tasks with pagination. Returns tasks in reverse chronological order.



## OpenAPI

````yaml /openapi.json get /images
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:
  /images:
    get:
      tags:
        - Image Generation
      summary: List images
      description: >-
        List your image generation tasks with pagination. Returns tasks in
        reverse chronological order.
      operationId: listImages
      parameters:
        - name: status
          in: query
          schema:
            type: string
            enum:
              - pending
              - processing
              - completed
              - failed
          description: Filter by generation status
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Page number (1-based)
        - name: limit
          in: query
          schema:
            type: integer
            default: 20
            maximum: 100
          description: Number of results per page
      responses:
        '200':
          description: Paginated list of image generation tasks
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedImagesResponse'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    PaginatedImagesResponse:
      type: object
      properties:
        images:
          type: array
          items:
            $ref: '#/components/schemas/ImageResponse'
          description: Array of image generation tasks
        pagination:
          type: object
          properties:
            total:
              type: integer
              description: Total number of images matching filters
            page:
              type: integer
              description: Current page number
            pageSize:
              type: integer
              description: Number of images 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
    ImageResponse:
      type: object
      properties:
        imageId:
          type: string
          description: Unique image identifier (img_xxx format)
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
          description: Current generation status
        model:
          type: string
          description: Image model used
        prompt:
          type: string
          description: Text prompt used for generation
        url:
          type: string
          format: uri
          description: >-
            URL to download the generated image (available when status is
            'completed')
        imageSize:
          type: string
          description: Aspect ratio used
        resolution:
          type: string
          description: Output resolution (nano-banana-2 only)
        outputFormat:
          type: string
          description: Output image format
        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

````