Cite the Record
Menu

Shard schema

Bill shard · 0.1.0

A Parliament bill. Carries session, sponsor, status, stages with dates, amendment count, and linked records (divisions, evidence, statements). Sourced from the Bills API.

This page is the field reference for developers and AI clients. If you came here looking for a bill, browse the bill index instead.

Draft field reference. Canonical .json file not published.

Verified example pending /schemas/bill@0.1.0.json (pending) Authoritative source Use with AI

Required fields

8

Optional fields

7

Dialect

JSON Schema draft 2020-12

Version

0.1.0

Required fields

Every shard validating against bill@0.1.0 ships these fields. Provenance lines show where each value comes from — the load-bearing column for the structured-evidence promise.

  • slug string<slug>

    URL-safe bill identifier.

    Provenance: Derived from displayName + session at admission.

    e.g. water-special-measures-bill

  • displayName string

    Bill name.

    Provenance: Bills API shortTitle.

  • officialId string

    Bills API billId.

    Provenance: Bills API billId verbatim.

  • session string

    Parliamentary session.

    Provenance: Bills API session field.

    e.g. 2024-25

  • canonicalUrl string<URL>

    Live bill page on bills.parliament.uk.

    Provenance: Constructed from the Bills API billId via the documented URL template at intake.

  • billType enum (4 values)

    Bill sub-type.

    • government
    • private_members
    • private
    • hybrid

    Provenance: Bills API billType.

  • status string

    Current stage / status.

    Provenance: Bills API currentStage.description.

  • provenance object

    Provenance for the bill snapshot.

    Provenance: Emitted by intake at bill-snapshot refresh.

Optional fields

Present where the source carries the value or the derivation succeeds. Code consuming this schema should treat them as nullable.

  • sponsor object · optional

    Bill sponsor.

    Provenance: Bills API sponsors[0] (or peer equivalent).

  • introducedAt string<ISO 8601> · optional

    Introduction date.

    Provenance: Bills API stages[firstReading].date.

  • royalAssentDate string<ISO 8601> · optional

    Royal Assent date if granted.

    Provenance: Bills API royalAssent.date.

  • stages array<object> · optional

    Stages with dates and outcomes.

    Provenance: Bills API stages array.

  • amendmentCount integer · optional

    Total amendments tabled.

    Provenance: Count of rows from the Bills API amendments endpoint.

  • recentRecords array<object> · optional

    Recent records linked to this bill (divisions, evidence, statements).

    Provenance: Records linked to this bill via the per-record entity links, ordered by published date.

  • outboundSources array<object> · optional

    External source links.

    Provenance: Bills API.

Source families for planned bill data

The following real source-family taxonomy is associated with bill@0.1.0. Click through for metadata and publication status.

Related schemas

Entities referenced by this shard kind. A bill shard's entities[] / nested references resolve to shards of these kinds.

Versioning + dialect
Schema id
bill@0.1.0
Dialect
https://json-schema.org/draft/2020-12/schema
Canonical .json
/schemas/bill@0.1.0.json (pending)
Verified example
Not linked until a verified live example is available.

Each planned schema follows semver. Patch bumps are additive and backwards-compatible. Minor bumps may add required fields or change validation rules. Major bumps will use a new URL path once canonical files are published.

Published structured data will declare its version in a $schema field. AI clients should respect that version when files become available.