---
title: "Get records (JSON)"
method: GET
path: "/documents/{id}/records"
tags: ["Documents"]
---

# Get records (JSON)

`GET /documents/{id}/records`

## Request

- Base URL: `https://klaaro.ai/api/v1`
- URL: `https://klaaro.ai/api/v1/documents/{id}/records`
- Auth: HTTP bearer

Returns all records for a document with pure extracted values per class schema. (JSON)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `includeUnapproved` boolean

## Response `200`

OK

- object
  - `records` RecordClean[]
    - `id` string, uuid, required
    - `documentId` string, uuid, required
    - `class` RecordClassRef, required
      - `slug` string, nullable, required
      - `name` string, nullable, required
      - `schemaHash` string, nullable, required: SHA-256 of field definitions at extraction time (pinned on record).
      - `classHash` string, nullable, required: SHA-256 of full class definition at extraction time (pinned on record).
    - `data` object, required: Pure nested extracted values ordered by class schema (no FieldView wrappers).
  - `class` DocumentClassRef
    - `slug` string, nullable, required: Class slug, e.g. invoice
    - `name` string, nullable, required: Display name at read time

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/klaaro/apis/klaaro-api.md) · [All operations](https://skmtc.dev/klaaro/apis/klaaro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/klaaro/apis/klaaro-api/revisions/053a1638b76c?raw)
