A curated topic landing produced by the auto-topic pipeline. Carries the display name, neutral description, date boundary, headline counts per record type, per-actor record counts (the mostActiveActors array), most-recent records, yearly timeline, and provenance for the topic itself (embedding model, labeling model, review timestamps).
Developer reference
JSON Schema registry
These pages document planned field shapes. Canonical JSON Schema files and verified examples are not published, and no publication date is committed.
These pages document planned field shapes. Canonical JSON Schema files and verified examples are not published, and no publication date is committed.
| Kind | Version | Required | Optional | Sample shard |
|---|---|---|---|---|
| Topic | topic@0.3.0 | 6 | 3 | |
| Record | record@0.4.0 | 10 | 7 | |
| Person | person@0.2.0 | 6 | 7 | |
| Department | department@0.1.0 | 4 | 9 | |
| Organisation | org@0.1.0 | 3 | 8 | |
| Constituency | constituency@0.1.0 | 6 | 7 | |
| Bill | bill@0.1.0 | 8 | 7 |
A single public record — written question, ministerial statement, oral evidence session, debate contribution, bill, division vote, committee report. Carries title, body text, source URL, breadcrumbs, named entities, system metadata, optional ParliamentTV block for broadcast records, and the full provenance chain back to the official source.
A person entity — current MP, peer, committee witness, former member. Carries identity, current roles, registered interests, recent written questions asked or answered, recent votes, and provenance back to the Members API and Register of Interests source.
A UK government department. Carries current ministers, record counts per type, top topics by record volume, recent records, and outbound official-source URLs.
An external organisation named in parliamentary records — company, charity, trade union, professional body, public body. Carries roles in records, top topics, and recent records mentioning the organisation.
A UK Parliamentary constituency. Carries current MP, geographic context, mention contexts in records, and recent records referencing the constituency.
A Parliament bill. Carries session, sponsor, status, stages with dates, amendment count, and linked records (divisions, evidence, statements). Sourced from the Bills API.
Versioning
Each planned schema follows semver. Patch changes (0.x.y) are additive and backwards-compatible. Minor changes (0.x.0) may add required fields or change validation rules. Major changes (1.0.0+) will use a new URL path when canonical schema files are published.
Published structured data will declare its schema version in a $schema field. AI clients should respect that declared version when files become available.