---
title: "AI-native LLM-ready export for a registered dataset slug (§198)"
method: GET
path: "/api/v1/exports/{dataset}/llm-ready"
tags: ["Exports"]
---

# AI-native LLM-ready export for a registered dataset slug (§198)

`GET /api/v1/exports/{dataset}/llm-ready`

## Request

- Base URL: `https://fonteum.com`
- URL: `https://fonteum.com/api/v1/exports/{dataset}/llm-ready`
- Auth: HTTP bearer

Returns a supported registered dataset slug as chunked text plus the structured, methodology, and citation fields available for that exporter, in one of three formats:

- `?format=json` (default) — a RAG envelope with `dataset`, optional `narrative`, `chunks[]`, and `meta`.
- `?format=ndjson` — newline-delimited JSON with a `_dataset_meta` header followed by chunks.
- `?format=text-blocks` — plain text with methodology, chunk, and citation delimiters.

Chunk fields and source/date metadata vary by registered dataset; inspect the selected response rather than assuming a universal provenance tuple. Narrative generation and cache headers are exporter-specific. Embeddings are omitted; consumers supply their own embedding model and storage.

Possible response headers include `X-Methodology-Version`, `X-Last-Refreshed` (deprecated; empty when canonical content-change evidence is unavailable), `X-Source-Release-Date` (empty when publisher release evidence is unavailable), `X-Artifact-Snapshot-Date`, `X-Total-Chunks`, and `X-Narrative-Cache-Hit`. Artifact snapshots never populate the refreshed or source-release headers.

## Path parameters

- `dataset` string, required

## Query parameters

- `format` 'json' | 'ndjson' | 'text-blocks'

## Response `200`

Dataset export. Content-Type varies by format.

- object
  - `data` object
    - `schema_version` string
    - `dataset` object
      - `slug` string
      - `display_name` string
      - `one_liner` string
      - `methodology_version` string
      - `snapshot_date` string, date
      - `refresh_cadence` string
      - `source_families` string[]
    - `narrative` string, nullable
    - `chunks` object[]
      - `id` string
      - `text` string
      - `data` object
      - `methodology` object
        - `version` string
        - `source` string
        - `source_url` string, uri
        - `last_checked` string, date-time
        - `cadence` string
        - `limitations` string[]
      - `citation` string
      - `chunk_type` 'national' | 'state' | 'underserved' | 'dataset_meta'
    - `meta` object
  - `meta` ResponseMeta
    - `request_id` string, required
    - `api_version` 'v1', required
    - `data_freshness` union, required: One source block or an array of source blocks. Fields keep content-change, publisher-release, artifact-snapshot, coverage, check, and observation timestamps separate; only a proved canonical content transition can make last_refreshed non-null.
      - DataFreshness
        - `source` string, required
        - `last_refreshed` string, date-time, nullable, required: Timestamp of the most recent proved content change. Null when canonical content evidence is unavailable, invalid, or conflicted.
        - `source_release_date` string, date-time, nullable: Publisher-issued release date represented by the response. Coverage and static artifact dates use their own fields and never advance last_refreshed.
        - `artifact_snapshot_date` string, date-time, nullable: Fonteum or static aggregate artifact snapshot represented by the response; not a publisher release or content-change timestamp.
        - `coverage_date` string, date-time, nullable: Source-data coverage date or period boundary; not a publisher release or content-change timestamp.
        - `last_checked_at` string, date-time, nullable: Latest workflow or source check, separate from content freshness.
        - `last_observed_at` string, date-time, nullable: Latest source_snapshots ledger observation, separate from content freshness.
        - `timestamp_basis` 'content_change', nullable: Present only when last_refreshed is backed by a proved canonical content transition.
        - `evidence_status` 'proved' | 'unavailable' | 'invalid' | 'conflicted' | 'error'
        - `next_refresh_eta` string, date-time, nullable
        - `cadence` string
      - DataFreshness[]
        - `source` string, required
        - `last_refreshed` string, date-time, nullable, required: Timestamp of the most recent proved content change. Null when canonical content evidence is unavailable, invalid, or conflicted.
        - `source_release_date` string, date-time, nullable: Publisher-issued release date represented by the response. Coverage and static artifact dates use their own fields and never advance last_refreshed.
        - `artifact_snapshot_date` string, date-time, nullable: Fonteum or static aggregate artifact snapshot represented by the response; not a publisher release or content-change timestamp.
        - `coverage_date` string, date-time, nullable: Source-data coverage date or period boundary; not a publisher release or content-change timestamp.
        - `last_checked_at` string, date-time, nullable: Latest workflow or source check, separate from content freshness.
        - `last_observed_at` string, date-time, nullable: Latest source_snapshots ledger observation, separate from content freshness.
        - `timestamp_basis` 'content_change', nullable: Present only when last_refreshed is backed by a proved canonical content transition.
        - `evidence_status` 'proved' | 'unavailable' | 'invalid' | 'conflicted' | 'error'
        - `next_refresh_eta` string, date-time, nullable
        - `cadence` string
    - `methodology_url` string, uri, required
    - `limitations_url` string, uri, required
    - `documentation_url` string, uri
    - `geo_scope_note` string
    - `pagination` object
      - `total` integer
      - `page` integer
      - `per_page` integer
    - `freshness` FreshnessBlock[]: Typed per-source stored-observation timing: snapshot date, configured target, and a computed age state. This measures the stored observation against Fonteum's configured target, not upstream publisher freshness. A `current` state requires a dated stored snapshot; an unconfirmable date renders `unknown`.
      - `source_id` string, required
      - `snapshot` string, date, nullable, required: Source publication date; null when unavailable (state then `unknown`).
      - `last_checked` string, date-time, required: Serve-time — the only `now` field.
      - `sla_days` integer, nullable
      - `sla_hours` integer, nullable
      - `age_hours` integer, nullable
      - `age_days` integer, nullable
      - `within_sla` boolean, nullable
      - `state` 'current' | 'degraded' | 'stale' | 'unknown', required
    - `freshness_policy` FreshnessPolicy: Present only when the request set `max_staleness`. Reports whether each consulted stored source observation met the caller's age bar; it does not assert that the upstream publisher released newer data.
      - `requested` true, required
      - `max_staleness` string, required
      - `max_staleness_hours` number, required
      - `mode` 'flag' | 'reject', required
      - `stale` boolean, required
      - `stale_sources` object[], required
        - `source_id` string
        - `state` 'current' | 'degraded' | 'stale' | 'unknown'
        - `age_hours` integer, nullable
        - `reason` 'exceeds_max_staleness' | 'freshness_unknown'
    - `attestation` TrustMark, required: Re-checkable attribution attached to v1 response metadata. The chain-head value is a 32-byte content hash, not an Ed25519 signature. Per-snapshot witness signatures use a separately scoped evidence object and never occupy this contract.
      - `attested_by` 'Fonteum', required
      - `standard` 'W3C-VC-2.0', required
      - `content_credential` 'C2PA-aligned Content Credentials for facts', required
      - `source` string, nullable, required
      - `as_of` string, nullable, required
      - `attestation_id` integer, nullable, required: Snapshot id when a specific snapshot is in scope; otherwise the live chain-head link index.
      - `chain_head_hash` string, nullable, required: Current chain-head content hash. This field is deliberately not named or represented as a signature.
      - `recheck_url` string, uri, required
      - `key_url` string, uri, required: Signing-key directory used by separately exposed chain and witness evidence.
      - `docs_url` string, uri, required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Resource not found.
- `429`: Rate limit exceeded.

---

[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)