---
title: "Paginated, citation-ready RAG chunk export (rag-chunks/v1)"
method: GET
path: "/api/v1/rag/chunks"
tags: ["Export"]
---

# Paginated, citation-ready RAG chunk export (rag-chunks/v1)

`GET /api/v1/rag/chunks`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/rag/chunks`
- Auth: HTTP bearer

Deterministic, paginated feed of citation-ready text chunks for entries included in the registered RAG corpus. No language model runs in the export pipeline. Emitted chunks carry the provenance fields available to that corpus entry plus a stable citation string; fields can be null, and corpus coverage is narrower than the complete source registry. Protected by the shared API-key minute/day quota; the read-only sample uses an additional trusted-client shard. Complements the page-level `/api/export`.

## Query parameters

- `limit` integer
- `cursor` integer

## Response `200`

A page of provenance-carrying chunks.

- RagChunkPage: A page of citation-ready RAG chunks (rag-chunks/v1).
  - `methodology_version` string
  - `corpus_snapshot` string
  - `total` integer: Total chunks in the full corpus.
  - `limit` integer: Effective page size after clamping.
  - `cursor` integer: Start index of this page.
  - `next_cursor` integer, nullable: Start index of the next page, or null at the end.
  - `chunk_count` integer
  - `chunks` RagChunk[]
    - `chunk_id` string: Stable id — safe as a vector-store primary key.
    - `dataset_id` string: Fonteum dataset slug (matches data_sources.slug).
    - `title` string
    - `section` 'overview' | 'limitations'
    - `text` string: Citation-ready prose templated from the registry.
    - `cite` string: Stable human-readable citation string.
    - `source_url` string, uri
    - `token_estimate` integer
    - `provenance` object: Source-specific provenance fields; unavailable fields can be null.

## Other responses

- `400`: limit / cursor failed validation (non-numeric or negative).
- `429`: API-key quota exceeded; Retry-After set.
- `500`: A chunk failed the export contract gate and was not served.

---

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