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

# List Figures

> List all figures extracted from a document.

## Overview

Returns all figure nodes extracted from a document. Does not require authentication for public documents.

## Request

<ParamField path="id" type="string" required>
  Document ID (e.g. `doc-abc123`) or 6-char short hash.
</ParamField>

<ParamField query="limit" type="integer">
  Max number of figures to return.
</ParamField>

<ParamField query="offset" type="integer">
  Number of figures to skip (for pagination).
</ParamField>

<RequestExample>
  ```bash theme={null}
  curl https://api.okrapdf.com/v1/documents/doc-abc123/entities/figures \
    -H "Authorization: Bearer okra_YOUR_KEY"
  ```
</RequestExample>

### Response (200)

```json theme={null}
{
  "nodes": [
    {
      "type": "figure",
      "value": "Figure 1: Revenue breakdown by segment"
    }
  ]
}
```