Docs

Schema

The shape of an issue file, field by field, and the six source tiers.

The shape of /latest.json and /issues/{n}.json. Field names are the database’s own. A field with no value is left out, never sent as null or as a placeholder. The schema is closed: a field not listed here does not appear.

Issuethe document
$schema (always present)
url
The schema this document follows.
number (always present)
integer
The issue's position among published issues, by date. 1 is the first.
date (always present)
date
The issue's calendar date, America/Chicago.
url (always present)
url
This document's own address.
edition (present when there is a value)
string
The edition line, when the issue carries one.
theme_headline (present when there is a value)
string
The issue's theme, drawn across its stories.
theme_dek (present when there is a value)
string
One or two sentences under the theme.
face_image (present when there is a value)
url
The issue's cover.
shipped_at (present when there is a value)
date-time
When the issue was first published, UTC.
fingerprint (always present)
sha-256
SHA-256 over every story's headline, dek and body, in rank order.
licence (always present)
string
The licence the stories are under.
licence_url (always present)
url
The terms of use.
story_count (always present)
integer
How many stories follow.
stories (always present)
object[]
The stories, in rank order.
Storyeach entry of stories
slug (always present)
string
The story's identifier. Unique within its issue.
ref (always present)
string
The code on the story's plate: GB, section, rank. Unique within its issue.
url (always present)
url
The story's page, the canonical address to cite.
md_url (always present)
url
The same story as markdown.
rank (always present)
integer
Position in the issue. 1 is the lead.
section (always present)
enum
The section: intelligence, frontier, life, money, world or disclosure.
category (present when there is a value)
string
The topic inside the section, as the pipeline filed it.
headline (always present)
string
The headline.
dek (present when there is a value)
string
One or two sentences under the headline.
place (present when there is a value)
string
Where the story is, in words.
dateline (present when there is a value)
string
The dateline as printed, when it differs from place.
lat (present when there is a value)
number
Latitude in decimal degrees. Present only with lon.
lon (present when there is a value)
number
Longitude in decimal degrees. Present only with lat.
body (always present)
string[]
The story, one paragraph per entry.
signal (present when there is a value)
string
The older one-line read, on stories without a Griffin Read.
why_it_matters (present when there is a value)
string
Why the story matters, when written as its own passage.
the_other_side (present when there is a value)
string
The strongest opposing reading, when written.
pull_quote (present when there is a value)
string
The quotation set apart on the story page.
griffin_read (present when there is a value)
string
The synthesis across the six lenses: what the story means.
signals (present when there is a value)
string[]
Key takeaways, as the story page lists them.
what_to_watch (present when there is a value)
string[]
What would confirm or change the read.
uncertainty (present when there is a value)
string
What is unconfirmed, inferred or weakly sourced.
topics (present when there is a value)
string[]
Tags.
sources (present when there is a value)
object[]
The sources listed on the story page.
sources_count (present when there is a value)
integer
How many sources the story counts, when recorded.
read_minutes (present when there is a value)
integer
Reading time in minutes.
hero_image (present when there is a value)
url
The story's plate.
audio_url (present when there is a value)
url
The story read aloud.
shipped_at (present when there is a value)
date-time
When the story was published, UTC.
corrections (present when there is a value)
object[]
Corrections issued since publication, oldest first. Absent when there are none.
Sourceeach entry of sources
title (always present)
string
The source's own title.
url (always present)
url
Where the source was read.
source_type (present when there is a value)
enum
The source tier: primary, official, secondary, analysis, social or other.
Correctioneach entry of corrections
corrected_at (always present)
date-time
When the correction was issued, UTC.
note (always present)
string
What was wrong and what is right.

The source tiers

source_type is one of six labels, assigned from the source’s address. An address cannot show everything: a company’s own statement about itself is filed secondary. Sources captured before 13 November 2026 are all secondary, or carry no tier.

primary
The document itself: a filing, a law, a court record, a paper, a dataset.
official
A government or intergovernmental body's own site.
secondary
Reporting by a news outlet. The default.
analysis
A think tank or a commentary platform.
social
A post on a social platform.
other
Reserved. Not assigned today.