> ## Documentation Index
> Fetch the complete documentation index at: https://docs.animusai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List dataset images



## OpenAPI

````yaml api-reference/openapi.json get /{character_id}/dataset/images
openapi: 3.1.0
info:
  version: 2.0.0
  title: Animus API
  description: >-
    Animus' API provides you with a variety of AI-driven capabilities. From
    generating text with our advanced large language models to creating
    customized content schedules, our API's applications are vast and versatile.

    Whether it's facilitating seamless conversation through predictive response
    or simulating a comprehensive content calendar, our advanced functionalities
    can cater to an array of feature requirements.
servers:
  - url: https://api.animusai.co/v2
security: []
paths:
  /{character_id}/dataset/images:
    get:
      tags:
        - Character Dataset
      summary: List dataset images
      operationId: getDatasetImages
      parameters:
        - name: character_id
          in: path
          required: true
          schema:
            type: string
        - name: approved_only
          in: query
          schema:
            type: boolean
          description: If true, only approved images are returned.
      responses:
        '200':
          description: Dataset images.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DatasetImagesResponse'
      security:
        - bearerAuth: []
components:
  schemas:
    DatasetImagesResponse:
      type: object
      properties:
        character_id:
          type: string
        images:
          type: array
          items:
            $ref: '#/components/schemas/DatasetImage'
        total:
          type: integer
        approved_count:
          type: integer
        dataset_status:
          type: string
    DatasetImage:
      type: object
      properties:
        image_id:
          type: string
        filename:
          type: string
        prompt:
          type: string
        seed:
          type: integer
        approved:
          type: boolean
        regenerated:
          type: boolean
        created_at:
          type: string
          format: date-time
        view_url:
          type: string
          format: uri
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````