Cite the Record
Menu

Shard schema

Organisation shard · 0.1.0

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.

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

Draft field reference. Canonical .json file not published.

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

Required fields

3

Optional fields

8

Dialect

JSON Schema draft 2020-12

Version

0.1.0

Required fields

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

    Provenance: Derived from displayName at admission.

    e.g. british-dental-association

  • displayName string

    Organisation name.

    Provenance: As named in the underlying records; cross-checked against Companies House / Charity Commission where possible.

  • provenance object

    Provenance for the org 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.

  • shortName string · optional

    Common abbreviation.

    Provenance: Curated at admission.

  • category enum (6 values) · optional

    Organisation sub-type.

    • company
    • charity
    • union
    • professional_body
    • public_body
    • other

    Provenance: Curated at admission; never inferred from text.

  • canonicalUrl string<URL> · optional

    External canonical URL.

    Provenance: Curated at admission (Companies House / Charity Commission / org website).

  • recordMentionCount integer · optional

    Total records naming this org.

    Provenance: Count over per-record entity links pointing at this org.

  • topRoles array<object> · optional

    Most-common neutral role labels the org appears under.

    Provenance: Aggregated from the role-label field on per-record entity links; vocabulary fixed by NEUTRALITY_POLICY.md.

  • topTopics array<object> · optional

    Top topics by record volume mentioning this org.

    Provenance: Aggregated from topic assignments over records that name this org.

  • recentRecords array<object> · optional

    Recent records mentioning this org.

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

  • outboundSources array<object> · optional

    External source links.

    Provenance: Curated at admission.

Related schemas

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

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