Cite the Record
Menu

Shard schema

Constituency shard · 0.1.0

A UK Parliamentary constituency. Carries current MP, geographic context, mention contexts in records, and recent records referencing the constituency.

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

Draft field reference. Canonical .json file not published.

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

Required fields

6

Optional fields

7

Dialect

JSON Schema draft 2020-12

Version

0.1.0

Required fields

Every shard validating against constituency@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 constituency identifier.

    Provenance: Derived from displayName; stable across boundary review unless the constituency is abolished.

    e.g. mid-devon

  • displayName string

    Official constituency name.

    Provenance: OS Boundary-Line; cross-checked against Members API constituency reference.

  • officialId string

    ONS GSS code (e.g. E14001392).

    Provenance: ONS geography portal.

  • country enum (4 values)

    Nation.

    • England
    • Scotland
    • Wales
    • Northern Ireland

    Provenance: ONS geography portal.

  • canonicalUrl string<URL>

    Constituency page on members.parliament.uk.

    Provenance: Constructed from the Members API constituency reference via the documented URL template.

  • provenance object

    Provenance for the constituency snapshot.

    Provenance: Emitted by intake at admission.

Optional fields

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

  • region string · optional

    Region (England) or null (Scotland / Wales / NI).

    Provenance: ONS geography portal.

  • boundaryReview string · optional

    Boundary-review generation this geometry belongs to.

    Provenance: OS Boundary-Line release tag.

    e.g. 2024

  • currentMP object · optional

    Current MP.

    Provenance: Members API latest constituency membership.

  • recordsMentioningCount integer · optional

    Records mentioning this constituency.

    Provenance: Count over records whose body text mentions the constituency name, derived by the geoparser at shard-build time.

  • topMentionContexts array<object> · optional

    Most-common record-types in which this constituency appears.

    Provenance: Aggregated from the record-type field of records mentioning the constituency.

  • recentRecords array<object> · optional

    Recent records mentioning this constituency.

    Provenance: Geoparser-derived constituency matches in record bodies, ordered by published date.

  • outboundSources array<object> · optional

    External source links.

    Provenance: Curated at admission.

Related schemas

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

Versioning + dialect
Schema id
constituency@0.1.0
Dialect
https://json-schema.org/draft/2020-12/schema
Canonical .json
/schemas/constituency@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.