---
title: "List File Page Figures"
method: GET
path: "/api/v1/files/{id}/page-figures/{page_index}"
tags: ["Page Figures"]
---

# List File Page Figures

`GET /api/v1/files/{id}/page-figures/{page_index}`

## Request

- Base URL: `https://api.cloud.llamaindex.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloud.llamaindex.ai/api/v1/files/{id}/page-figures/{page_index}`
- Auth: HTTP bearer

List metadata for figures from a specific page of a file.

## Path parameters

- `id` string, uuid, required
- `page_index` integer, required

## Query parameters

- `project_id` string, uuid, nullable
- `organization_id` string, uuid, nullable

## Cookies

- `session` string, nullable

## Response `200`

Successful Response

- PageFigureMetadata[]
  - `figure_name` string, required: The name of the figure
  - `file_id` string, uuid, required: The ID of the file that the figure was taken from
  - `page_index` integer, required: The index of the page for which the figure is taken (0-indexed)
  - `figure_size` integer, required: The size of the figure in bytes
  - `is_likely_noise` boolean: Whether the figure is likely to be noise
  - `confidence` number, required: The confidence of the figure
  - `metadata` object, nullable: Metadata for the figure

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `a38b684f8e1b`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-06-09** `614771991b52`: 2 warning
  - removed the optional property `detail/items/ctx` from the response with the `422` status
  - removed the optional property `detail/items/input` from the response with the `422` status
- **2026-06-09** `b17341164de9`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status

[Operation history](https://skmtc.dev/run-llama/apis/llama-platform/changes/api/v1/files/:id/page-figures/:page_index/get.md)

---

[API](https://skmtc.dev/run-llama/apis/llama-platform.md) · [All operations](https://skmtc.dev/run-llama/apis/llama-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/run-llama/apis/llama-platform/revisions/eacba11f3303?raw)