---
title: "Get Figures"
method: GET
path: "/admin/figures"
tags: ["admin-figures"]
---

# Get Figures

`GET /admin/figures`

Get all figures with filtering and pagination.

## Query parameters

- `status` string, nullable — Filter by status
- `source_type` string, nullable — Filter by source type
- `start_date` string, nullable — Filter by start date (YYYY-MM-DD)
- `end_date` string, nullable — Filter by end date (YYYY-MM-DD)
- `search` string, nullable — Search by user email
- `skip` integer
- `limit` integer

## Response `200`

Successful Response

- FiguresListResponse — Response model for the figures list endpoint.
  - `figures` RoutersAdminFiguresFigureResponse[], required
    - `id` string, required
    - `status` string, required
    - `content` string, nullable
    - `code` string, nullable
    - `error_message` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `author_id` string, required
    - `author_email` string, nullable
    - `generation_duration_seconds` number, nullable
    - `generation_metadata` FigureGenerationMetadataResponse — Response model for figure generation metadata.
      - `source_type` string, nullable
      - `exercise_session_id` string, nullable
      - `teacher_exam_id` string, nullable
      - `exam_exercise_id` integer, nullable
      - `block_id` string, nullable
      - `description` string, nullable
      - `image_urls` string[]
      - `instructions` string, nullable
      - `exercise_content` string, nullable
      - `reprompted_from_id` string, nullable
      - `solution_content` string, nullable
      - `exercise_figure_code` string, nullable
      - `is_solution_figure` boolean
      - `current_code` string, nullable
      - `current_diagram_url` string, nullable
    - `original_source` OriginalSourceInfo — Info about the original source figure (for reprompts).
      - `figure_id` string, required
      - `source_type` string, nullable
      - `exercise_session_id` string, nullable
      - `teacher_exam_id` string, nullable
  - `stats` FiguresStatsResponse, required — Stats about figures.
    - `total` integer, required
    - `completed` integer, required
    - `failed` integer, required
    - `processing` integer, required
    - `pending` integer, required
    - `weekly_new` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/c407f3b5a05b/schema)