Stay organized with collections
Save and categorize content based on your preferences.
BallotMeasureScope entities are used to describe a ballot measure that's being
voted upon in an ElectionEvent.
Name
Tag
Type
Notes
Multiplicity
Debug name
DebugName
String
Descriptive name used for the ballot measure.
0 or 1
Location level
Location Level
OfficeLevel
The location level of the ballot measure: Country for
national, Administrative Area 1 for a state or province,
etc.
1
Location OCD ID
LocationOcdId
Ocd Id
Optional if LocationLevel is Country,
otherwise required. The OCD IDs of the location of the ballot
measure.
0 or 1
Title or topic
TitleOrTopic
String
Title of the ballot measure, if known. Otherwise, a short description
of the topic.
1
Examples
The following example is a Feed that contains an ElectionEvent with
BallotMeasureScope. It indicates that the Feed contains data about a ballot
measure that will be held in California:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-08-21 UTC."],[[["\u003cp\u003e\u003ccode\u003eBallotMeasureScope\u003c/code\u003e entities solely appear in metadata feeds, providing context about ballot measures within an \u003ccode\u003eElectionEvent\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThese entities detail the geographic scope of a ballot measure, specifying the location level and OCD ID.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eBallotMeasureScope\u003c/code\u003e includes either the official title or a concise topic description of the ballot measure.\u003c/p\u003e\n"],["\u003cp\u003eThis entity is exclusively for metadata and isn't utilized in pre-election, election, or officeholder data feeds.\u003c/p\u003e\n"]]],[],null,["# BallotMeasureScope\n\n| **Note:** This entity is only used in metadata feeds. It isn't used with pre-election, election, or officeholder feeds.\n\n`BallotMeasureScope` entities are used to describe a ballot measure that's being\nvoted upon in an [`ElectionEvent`](/civics-data/reference/election-event).\n\n| Name | Tag | Type | Notes | Multiplicity |\n|-----------------|------------------|---------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------|--------------|\n| Debug name | `DebugName` | `String` | Descriptive name used for the ballot measure. | 0 or 1 |\n| Location level | `Location Level` | [](/civics-data/reference/office-level)`OfficeLevel` | The location level of the ballot measure: `Country` for national, `Administrative Area 1` for a state or province, etc. | 1 |\n| Location OCD ID | `LocationOcdId` | [](https://github.com/opencivicdata/ocd-division-ids)`Ocd Id` | Optional if `LocationLevel` is `Country`, otherwise required. The OCD IDs of the location of the ballot measure. | 0 or 1 |\n| Title or topic | `TitleOrTopic` | `String` | Title of the ballot measure, if known. Otherwise, a short description of the topic. | 1 |\n\nExamples\n--------\n\nThe following example is a `Feed` that contains an `ElectionEvent` with\n`BallotMeasureScope`. It indicates that the `Feed` contains data about a ballot\nmeasure that will be held in California: \n\n### XML\n\n```xml\n\u003cBallotMeasureScope\u003e\n \u003cDebugName\u003eCalifornia state Ballot measures\u003c/DebugName\u003e\n \u003cLocationLevel\u003eAdministrative Area 1\u003c/LocationLevel\u003e\n \u003cLocationOcdId\u003eocd-division/country:us/state:ca\u003c/LocationOcdId\u003e\n \u003cTitleOrTopic\u003eRemove Voter Approval Requirement for Public Low-Rent Housing Projects Amendment\u003c/TitleOrTopic\u003e\n\u003c/BallotMeasureScope\u003e\n```\n\n### JSON\n\n```json\n{\n \"BallotMeasureScope\": {\n \"DebugName\": \"California state Ballot measures\",\n \"LocationLevel\": \"Administrative Area 1\",\n \"LocationOcdId\": \"ocd-division/country:us/state:ca\",\n \"TitleOrTopic\": \"Remove Voter Approval Requirement for Public Low-Rent Housing Projects Amendment\"\n }\n}\n```"]]