---
title: "Get Document Extracted Entities"
method: GET
path: "/documents/{document_id}/entities"
tags: ["entities"]
---

# Get Document Extracted Entities

`GET /documents/{document_id}/entities`

## Path parameters

- `document_id` string, uuid, required — The id of the document.

## Query parameters

- `cursor` string, nullable — An opaque cursor for pagination
- `page_size` integer — The number of items per page (must be greater than 0 and less than or equal to 100)

## Headers

- `partition` string, nullable — An optional partition to scope the request to. If omitted, accounts created after 1/9/2025 will have the request scoped to the default partition, while older accounts will have the request scoped to all partitions. Older accounts may opt in to strict partition scoping by contacting support@ragie.ai. Older accounts using the partitions feature are strongly recommended to scope the request to a partition.

## Response `200`

Successful Response

- EntityList
  - `pagination` Pagination, required
    - `next_cursor` string, nullable
    - `total_count` integer, required
  - `entities` Entity[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `instruction_id` string, uuid, required — The ID of the instruction which generated the entity.
    - `document_id` string, uuid, required — The ID of the document which the entity was produced from.
    - `chunk_id` string, uuid, nullable
    - `data` EntityData, required
    - `instruction_schema_version` integer, nullable — Instruction entity schema version used to generate this entity.
    - `instruction_schema_shape_fingerprint` string, nullable — Shape-only fingerprint of the instruction entity schema used to generate this entity.

## Other responses

- `401` — Unauthorized
- `402` — Payment Required
- `422` — Validation Error
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.dev/ragie/apis/ragie-api.md) · [All operations](https://skmtc.dev/ragie/apis/ragie-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ragie/ragie-api/revisions/ffdf960539ca/schema)