Search Hansard Debates

Previous value: -"Full citable attribution string, e.g. 'The Minister of State, DESNZ (Lord Whitehead) (Lab)'. Includes role-at-time of contribution for ministerial interventions."New value: +"Full citable attribution string, verbatim from Hansard, e.g. 'The Minister of State, DESNZ (Lord Whitehead) (Lab)' or 'Lord Pannick (CB)'. This is the authoritative citation text — quote it as-is rather than reconstructing it from other fields."

Previous value: -"Constituency (Commons only; None for Lords)"New value: +"Constituency (Commons only; None for Lords). Not currently populated from AttributedTo — see `party`'s note on why positional parsing of that string is unsafe; use parliament_find_member for authoritative constituency."

Previous value: -"Members API integer ID. Use as {member_id} in hansard://member/{member_id}/biography for the member's role history."New value: +"Members API integer ID. Use as {member_id} in hansard://member/{member_id}/biography for the member's role history. None for a collective or otherwise unresolved attribution (e.g. 'Hon. Members') — Hansard itself has no member to identify there."

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Added value: +null

Previous value: -"Name of the contributing member (MemberName)"New value: +"Authoritative display name of the contributing member — populated ONLY when the source endpoint itself supplies a real name field, never derived by parsing `attributed_to`. Populated from Hansard's MemberName field on the search endpoints (parliament_search_hansard, parliament_member_debates). ALWAYS None from parliament_get_debate_contributions (backed by /debates/Debate/{ext}.json), because DebateItem has no MemberName field at all — only `AttributedTo` (a citation-display string) and `member_id`. AttributedTo's shape varies unpredictably (own name first, hereditary-title styling, ministerial office, chair/speaker role, annotations, collective labels — e.g. 'Lord Pannick (CB)' vs 'The Earl of Devon (CB)' vs 'Madam Deputy Speaker (Judith Cummins)' vs 'Madam Deputy Speaker' alone, all verified live) with no positional rule that reliably recovers the person's name across all of them — two earlier attempts ('use the last parenthesis', then 'unless it starts with `The `') were each falsified by a real, live counterexample. `attributed_to` is preserved in full instead of being decomposed into a guess. Resolve authoritative identity via `member_id` and parliament_find_member when this is None."

Removed value: -"string"

Previous value: -"Political party affiliation parsed from the trailing '(Party)' suffix in AttributedTo"New value: +"ALWAYS None. Hansard's AttributedTo is a citation-display string Hansard composes for readability, not structured party data — neither the search-contributions nor the debate-items schema declares a Party field, and the parenthesised text varies by convention (constituency, party, office, 'Maiden Speech', a virtual-attendance marker, or nothing at all) in ways that cannot be told apart by position alone. Guessing a party from it previously produced fabricated values for ministers/officeholders (e.g. party='Lucy Powell' for 'The Leader of the House of Commons (Lucy Powell)'). For a member's authoritative party, resolve `member_id` via parliament_find_member against the Members API's structured latestParty field."

Previous value: -[
-  "member_name",
-  "attributed_to",
-  "date",
-  "debate_title",
-  "debate_id",
-  "debate_ext_id",
-  "contribution_ext_id",
-  "chamber_section",
-  "house",
-  "text",
-  "url"
-]New value: +[
+  "attributed_to",
+  "date",
+  "debate_title",
+  "debate_id",
+  "debate_ext_id",
+  "contribution_ext_id",
+  "chamber_section",
+  "house",
+  "text",
+  "url"
+]

Previous value: -"Counts by party across the returned page"New value: +"ALWAYS EMPTY. Hansard's contribution schema has no structured party field (see HansardContribution.party) — an aggregation over unjustified values would just be a party-shaped guess. Kept as a field (rather than removed) for schema stability. For real party facets, resolve member_id per contribution via parliament_find_member; this tool does not do that automatically — it would cost one extra HTTP call per distinct member in the page."

Previous value: -"Internal Hansard debate ID (DebateSectionId)"New value: +"Internal Hansard debate ID."

Added value: +{
+  "default": "Spoken",
+  "description": "Which Hansard section to paginate. 'Spoken' = chamber + Westminster Hall debates (the default; what a lawyer usually means). 'Written' = written answers and statements. 'Corrections' = published corrections to the record. The corpus envelope (total_debates, total_divisions, etc.) is independent of this and always populated.",
+  "enum": [
+    "Spoken",
+    "Written",
+    "Corrections"
+  ],
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "format": "date",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Start date (YYYY-MM-DD)"
+}

Added value: +{
+  "default": "both",
+  "description": "Restrict to one House. Default 'both' returns Commons + Lords contributions.",
+  "enum": [
+    "Commons",
+    "Lords",
+    "both"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": 20,
+  "description": "Max contributions per call (1–100). Default 20. Paginate further with offset; total corpus size is in total_corpus on the response.",
+  "maximum": 100,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "anyOf": [
+    {
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Filter to contributions by a single member. Pass the integer Members API ID (resolve a name via parliament_find_member). The prior `member` field accepted a name string but Hansard's /search.json silently ignored it — the spec requires `memberId`."
+}

Added value: +{
+  "default": 0,
+  "description": "Skip this many contributions before the page. Default 0. Re-call with offset=offset+returned to paginate; has_more flags whether more remain.",
+  "maximum": 5000,
+  "minimum": 0,
+  "type": "integer"
+}

Removed value: -{
-  "additionalProperties": false,
-  "description": "HansardSearchInput.",
-  "properties": {
-    "contribution_type": {
-      "default": "Spoken",
-      "description": "Which Hansard section to paginate. 'Spoken' = chamber + Westminster Hall debates (the default; what a lawyer usually means). 'Written' = written answers and statements. 'Corrections' = published corrections to the record. The corpus envelope (total_debates, total_divisions, etc.) is independent of this and always populated.",
-      "enum": [
-        "Spoken",
-        "Written",
-        "Corrections"
-      ],
-      "type": "string"
-    },
-    "from_date": {
-      "anyOf": [
-        {
-          "format": "date",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "description": "Start date (YYYY-MM-DD)"
-    },
-    "house": {
-      "default": "both",
-      "description": "Restrict to one House. Default 'both' returns Commons + Lords contributions.",
-      "enum": [
-        "Commons",
-        "Lords",
-        "both"
-      ],
-      "type": "string"
-    },
-    "limit": {
-      "default": 20,
-      "description": "Max contributions per call (1–100). Default 20. Paginate further with offset; total corpus size is in total_corpus on the response.",
-      "maximum": 100,
-      "minimum": 1,
-      "type": "integer"
-    },
-    "member_id": {
-      "anyOf": [
-        {
-          "minimum": 1,
-          "type": "integer"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "description": "Filter to contributions by a single member. Pass the integer Members API ID (resolve a name via parliament_find_member). The prior `member` field accepted a name string but Hansard's /search.json silently ignored it — the spec requires `memberId`."
-    },
-    "offset": {
-      "default": 0,
-      "description": "Skip this many contributions before the page. Default 0. Re-call with offset=offset+returned to paginate; has_more flags whether more remain.",
-      "maximum": 5000,
-      "minimum": 0,
-      "type": "integer"
-    },
-    "query": {
-      "description": "Phrase to find in Hansard contribution text bodies. Hansard searches the words members actually said in their speeches — NOT debate titles, topic metadata, or written headlines. Pass tokens that would appear in someone's speech: distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or specific phrases. Bill titles (e.g. 'Renters' Rights Bill') often DON'T match because members refer to 'the Bill' or 'this legislation' in their speeches. Tokenised matching: 'housing benefit fraud' will match contributions saying 'fraud in housing benefit claims'. For 'all contributions in a specific debate' regardless of words used, drill via top_debates[].debate_ext_id into parliament_get_debate_contributions.",
-      "maxLength": 500,
-      "minLength": 1,
-      "type": "string"
-    },
-    "text_mode": {
-      "default": "preview",
-      "description": "'preview' returns the upstream ~250-char snippet (fast, low context cost). 'full' returns ContributionTextFull (still capped at 3000 chars). For full contribution text without the cap, read the resource hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}.",
-      "enum": [
-        "preview",
-        "full"
-      ],
-      "type": "string"
-    },
-    "to_date": {
-      "anyOf": [
-        {
-          "format": "date",
-          "type": "string"
-        },
-        {
-          "type": "null"
-        }
-      ],
-      "default": null,
-      "description": "End date (YYYY-MM-DD)"
-    }
-  },
-  "required": [
-    "query"
-  ],
-  "type": "object"
-}

Added value: +{
+  "description": "Phrase to find in Hansard contribution text bodies. Hansard searches the words members actually said in their speeches — NOT debate titles, topic metadata, or written headlines. Pass tokens that would appear in someone's speech: distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or specific phrases. Bill titles (e.g. 'Renters\\'s Rights Bill') often DON'T match because members refer to 'the Bill' or 'this legislation' in their speeches. Tokenised matching: 'housing benefit fraud' will match contributions saying 'fraud in housing benefit claims'. For 'all contributions in a specific debate' regardless of words used, drill via top_debates[].debate_ext_id into parliament_get_debate_contributions.",
+  "maxLength": 500,
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "default": "preview",
+  "description": "'preview' returns the upstream ~250-char snippet (fast, low context cost). 'full' returns ContributionTextFull (still capped at 3000 chars). For full contribution text without the cap, read the resource hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}.",
+  "enum": [
+    "preview",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "format": "date",
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "End date (YYYY-MM-DD)"
+}

Previous value: -[
-  "params"
-]New value: +[
+  "query"
+]

Previous value: -"HansardSearchInput with query, optional date range, optional member filter."New value: +"HansardSearchInput."

Added value: +{
+  "default": "Spoken",
+  "description": "Which Hansard section to paginate. 'Spoken' = chamber + Westminster Hall debates (the default; what a lawyer usually means). 'Written' = written answers and statements. 'Corrections' = published corrections to the record. The corpus envelope (total_debates, total_divisions, etc.) is independent of this and always populated.",
+  "enum": [
+    "Spoken",
+    "Written",
+    "Corrections"
+  ],
+  "type": "string"
+}

Added value: +{
+  "default": "both",
+  "description": "Restrict to one House. Default 'both' returns Commons + Lords contributions.",
+  "enum": [
+    "Commons",
+    "Lords",
+    "both"
+  ],
+  "type": "string"
+}

Previous value: -"Maximum contributions to return in this call. Default 20 keeps responses focused; raise to 100 for a bulk sweep."New value: +"Max contributions per call (1–100). Default 20. Paginate further with offset; total corpus size is in total_corpus on the response."

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Filter by member name"
-}

Added value: +{
+  "anyOf": [
+    {
+      "minimum": 1,
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Filter to contributions by a single member. Pass the integer Members API ID (resolve a name via parliament_find_member). The prior `member` field accepted a name string but Hansard's /search.json silently ignored it — the spec requires `memberId`."
+}

Previous value: -"Number of contributions to skip before this page. Default 0. Re-call with offset=offset+returned while has_more is true to paginate."New value: +"Skip this many contributions before the page. Default 0. Re-call with offset=offset+returned to paginate; has_more flags whether more remain."

Previous value: -2000New value: +5000

Previous value: -"Full phrase to search in Hansard debates. Pass the complete topic, e.g. 'short selling regulation' or 'artificial intelligence liability'. Searched as an exact phrase — do not truncate to a single keyword."New value: +"Phrase to find in Hansard contribution text bodies. Hansard searches the words members actually said in their speeches — NOT debate titles, topic metadata, or written headlines. Pass tokens that would appear in someone's speech: distinctive arguments ('disproportionate sanction'), statutory references ('section 21'), or specific phrases. Bill titles (e.g. 'Renters' Rights Bill') often DON'T match because members refer to 'the Bill' or 'this legislation' in their speeches. Tokenised matching: 'housing benefit fraud' will match contributions saying 'fraud in housing benefit claims'. For 'all contributions in a specific debate' regardless of words used, drill via top_debates[].debate_ext_id into parliament_get_debate_contributions."

Added value: +{
+  "default": "preview",
+  "description": "'preview' returns the upstream ~250-char snippet (fast, low context cost). 'full' returns ContributionTextFull (still capped at 3000 chars). For full contribution text without the cap, read the resource hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}.",
+  "enum": [
+    "preview",
+    "full"
+  ],
+  "type": "string"
+}

Previous value: -"Result of a Hansard debate search.\n\nWraps the list of matching contributions with the query and filters\nso the client sees a real nested object on the wire."New value: +"Result of a Hansard debate search.\n\nWraps the list of matching contributions with the query, filters,\nand corpus-level facet counts so the client sees a real nested object\non the wire."

Previous value: -"Matching Hansard contributions. Each `text` field is capped at 3000 characters."New value: +"Matching Hansard contributions with full citation metadata."

Previous value: -"A single Hansard debate contribution."New value: +"A single Hansard debate contribution with citation-grade metadata.\n\nField provenance maps to the upstream hansard-api.parliament.uk\n`Contributions[i]` payload, so callers can footnote a contribution\nwithout re-querying."

Added value: +{
+  "description": "Full citable attribution string, e.g. 'The Minister of State, DESNZ (Lord Whitehead) (Lab)'. Includes role-at-time of contribution for ministerial interventions.",
+  "type": "string"
+}

Added value: +{
+  "description": "Hansard section bucket (Section): 'Commons Chamber', 'Lords Chamber', 'Westminster Hall', 'Written Answers', 'Written Statements'.",
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "The last Hansard column number this contribution spans, e.g. when a long speech runs across columns 200–203. Equal to `column_start` for short contributions. Same population semantics as `column_start`."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Hansard internal page-marker code from HansardSection (e.g. 'BE-BG1', 'AA-AD'). NOT the citable column number that appears in an OSCOLA footnote — see `column_start` / `column_end` for those, which are only available when reading the contribution via hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}. From parliament_search_hansard, only this page-marker is exposed."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "The citable Hansard column number where this contribution begins, e.g. 200, 1162. Extracted from `data-column-number` markers in the contribution HTML. Populated only when reading via the contribution resource — `parliament_search_hansard` returns this as None because Hansard's /search.json strips the column markers. To get the real column number for a search hit, read hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}."
+}

Added value: +{
+  "description": "ContributionExtId GUID — stable citation key. Use as {contribution_ext_id} in hansard://debate/{debate_ext_id}/contribution/{contribution_ext_id}.",
+  "type": "string"
+}

Previous value: -"Date the contribution was made"New value: +"Date the contribution was made (SittingDate)"

Added value: +{
+  "description": "DebateSectionExtId GUID. Use as {debate_ext_id} in hansard://debate/{debate_ext_id}/header.",
+  "type": "string"
+}

Added value: +{
+  "description": "Integer DebateSectionId — internal Hansard identifier",
+  "type": "integer"
+}

Previous value: -"Title of the debate or question"New value: +"Title of the debate or question (DebateSection)"

Added value: +{
+  "description": "House of Parliament (House)",
+  "enum": [
+    "Commons",
+    "Lords"
+  ],
+  "type": "string"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Members API integer ID. Use as {member_id} in hansard://member/{member_id}/biography for the member's role history."
+}

Previous value: -"Name of the contributing member"New value: +"Name of the contributing member (MemberName)"

Previous value: -"Political party affiliation"New value: +"Political party affiliation parsed from the trailing '(Party)' suffix in AttributedTo"

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Upstream relevance score (Rank). Higher = more relevant to the query."
+}

Removed value: -{
-  "description": "Hansard section (e.g. 'Commons Chamber', 'Written Answers')",
-  "type": "string"
-}

Previous value: -"Full text of the contribution (capped at 3000 characters)"New value: +"Contribution text (capped per max_text_chars on the input; default 3000). Source: ContributionTextFull when text_mode='full', ContributionText preview otherwise."

Previous value: -"Direct Hansard URL to this contribution"New value: +"Public hansard.parliament.uk URL for this contribution (synthesised from House/Date/DebateSectionExtId/ContributionExtId)."

Previous value: -[
-  "member_name",
-  "date",
-  "debate_title",
-  "section",
-  "text",
-  "url"
-]New value: +[
+  "member_name",
+  "attributed_to",
+  "date",
+  "debate_title",
+  "debate_id",
+  "debate_ext_id",
+  "contribution_ext_id",
+  "chamber_section",
+  "house",
+  "text",
+  "url"
+]

Added value: +{
+  "anyOf": [
+    {
+      "maxItems": 2,
+      "minItems": 2,
+      "prefixItems": [
+        {
+          "format": "date",
+          "type": "string"
+        },
+        {
+          "format": "date",
+          "type": "string"
+        }
+      ],
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "(min, max) SittingDate of returned contributions, or None if empty"
+}

Added value: +{
+  "default": "both",
+  "description": "House filter applied",
+  "enum": [
+    "Commons",
+    "Lords",
+    "both"
+  ],
+  "type": "string"
+}

Added value: +{
+  "additionalProperties": {
+    "type": "integer"
+  },
+  "description": "Counts by house across the returned page",
+  "type": "object"
+}

Removed value: -{
-  "anyOf": [
-    {
-      "type": "string"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "default": null,
-  "description": "Member name filter applied, if any"
-}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Members API integer ID filter applied, if any (echoed from input)."
+}

Added value: +{
+  "additionalProperties": {
+    "type": "integer"
+  },
+  "description": "Counts by party across the returned page",
+  "type": "object"
+}

Added value: +{
+  "default": "preview",
+  "description": "Whether contribution `text` carries the upstream preview or full body (still capped).",
+  "enum": [
+    "preview",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Top-ranked debates touching this topic (from upstream Debates[] preview, capped at 4 by Hansard's /search.json). Each entry's `debate_ext_id` chains to hansard://debate/{debate_ext_id}/header.",
+  "items": {
+    "description": "A top debate section returned as a search/lookup preview or aggregate result.",
+    "properties": {
+      "contribution_count": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Number of contributions in this debate. Populated only when the emitting tool fetches the debate's full Items list (today: parliament_lookup_by_column). Null on preview arrays where the secondary fetch is too costly."
+      },
+      "date": {
+        "description": "Sitting date of the debate",
+        "format": "date",
+        "type": "string"
+      },
+      "debate_ext_id": {
+        "description": "Debate GUID. Use as {debate_ext_id} in hansard://debate/{debate_ext_id}/header.",
+        "type": "string"
+      },
+      "debate_id": {
+        "description": "Internal Hansard debate ID (DebateSectionId)",
+        "type": "integer"
+      },
+      "debate_title": {
+        "description": "Debate title",
+        "type": "string"
+      },
+      "house": {
+        "description": "House",
+        "enum": [
+          "Commons",
+          "Lords"
+        ],
+        "type": "string"
+      },
+      "relevance_rank": {
+        "anyOf": [
+          {
+            "minimum": 0,
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Upstream Hansard relevance score for this debate against the search query (0–100). Populated for relevance-scored searches (parliament_search_hansard, parliament_policy_position_summary). Null for column-lookup matches — the column-search endpoint does not rank."
+      },
+      "source": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Human-readable Hansard publication state (Swagger Source enum name). Tells a lawyer the citation's finality — RollingHansard/DailyHansard are pre-consolidation, BoundVolume/Historic are final bound volumes. Does NOT indicate whether the citation resolves: column lookup resolves across all four states."
+      },
+      "source_code": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Raw Hansard Overview.Source ordinal: 1=RollingHansard, 2=DailyHansard, 3=BoundVolume, 4=Historic. Populated only when the emitting tool fetches the debate payload (today: parliament_lookup_by_column); null otherwise."
+      }
+    },
+    "required": [
+      "debate_id",
+      "debate_ext_id",
+      "debate_title",
+      "date",
+      "house"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Top-ranked divisions touching this topic (from upstream Divisions[] preview, capped at 4). Each entry's `id` chains to votes_get_division; `debate_section_ext_id` chains back to the parent debate.",
+  "items": {
+    "description": "A single division (formal parliamentary vote) — lightweight match shape.\n\nReturned as a preview slice on `parliament_search_hansard`'s `top_divisions`\nand as the full element of `parliament_get_debate_divisions`'s output.\n\nField provenance maps to the upstream `DivisionOverview` Swagger definition;\nthe live `/debates/divisions/{ext}` endpoint returns most integer/boolean\nvalues as strings, which the parser converts.",
+    "properties": {
+      "ayes_count": {
+        "description": "Number of Aye votes.",
+        "minimum": 0,
+        "type": "integer"
+      },
+      "date": {
+        "description": "Sitting date of the division (Date).",
+        "format": "date",
+        "type": "string"
+      },
+      "debate_section": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Parent debate title (DebateSection), e.g. 'Renters' Rights Bill'."
+      },
+      "debate_section_ext_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Parent debate GUID (DebateSectionExtId). Use as {debate_ext_id} in hansard://debate/{debate_ext_id}/header to read the surrounding debate context."
+      },
+      "external_id": {
+        "description": "Division GUID (ExternalId). Stable identifier for cross-reference.",
+        "type": "string"
+      },
+      "house": {
+        "description": "House where the division was held.",
+        "enum": [
+          "Commons",
+          "Lords"
+        ],
+        "type": "string"
+      },
+      "id": {
+        "description": "Hansard-side division ID — distinct ID-space from the Lords/Commons Votes API. This value does NOT chain to votes_get_division (different API). For per-member voting, see `votes_id` below — populated when cross-resolution succeeded.",
+        "type": "integer"
+      },
+      "motion_text": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "The motion being voted on (TextBeforeVote), e.g. 'Division on Motion A1'. This is the citable description of what the division decided."
+      },
+      "noes_count": {
+        "description": "Number of Noe votes.",
+        "minimum": 0,
+        "type": "integer"
+      },
+      "number": {
+        "description": "Division number within the sitting (e.g. '1', '2').",
+        "type": "string"
+      },
+      "result_text": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "The result statement (TextAfterVote), e.g. 'Motion A1 disagreed.'"
+      },
+      "time": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Time of the division as HH:MM:SS, or None when the upstream omits it."
+      },
+      "votes_id": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "default": null,
+        "description": "Lords/Commons Votes API division ID, cross-resolved from the upstream by (date + house + number). Use as the `division_id` input to votes_get_division for the full member-by-member voting record. None when the cross-resolve found no match (e.g. some Daily Part divisions are recorded in Hansard before the Votes API publishes them)."
+      }
+    },
+    "required": [
+      "id",
+      "external_id",
+      "number",
+      "date",
+      "house",
+      "ayes_count",
+      "noes_count"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalCommittees."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Total contributions in Hansard matching this query (TotalContributions). Use to decide whether to paginate further or escalate to parliament_policy_position_summary."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalCorrections — published corrections to the Hansard record."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalDebates — distinct debates touching this topic."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalDivisions. Non-zero → consider `top_divisions` previews below or chain to votes_search_divisions."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalMembers — member-name matches in the corpus."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalPetitions."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalWrittenAnswers."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "TotalWrittenStatements."
+}