Stay organized with collections
Save and categorize content based on your preferences.
The following table lists the enumerations for date status in the
Contest and
Election entities:
Value
Description
confirmed
Used when the election dates are confirmed.
canceled
Used when an election is canceled.
postponed
Used if an election is postponed and no new date is set. If an
election is postponed and no new date has been set, set the
ElectionDateStatus to postponed and leave the original StartDate and
EndDate in place. When a new date is set, update the dates and set the
ElectionDateStatus back to confirmed.
tentative
This usually reflects that the election or contest itself is at risk
of not happening, and not its date specifically. For example, a round 2
election (date is known but the contest may or may not happen depending
on round 1 results), or, a very low probability snap election.
changing
The election or contest is likely to happen, but the date is highly
likely to change. For example, a high probability snap election whose date
is being speculated, or other regional factors leading to an actual change
in an election's date. Use `changing` if an election has a high risk and
it is unclear if it will result in just a changed date or a canceled date.
[[["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\u003eThe \u003ccode\u003edateStatus\u003c/code\u003e field, used in \u003ccode\u003eContest\u003c/code\u003e and \u003ccode\u003eElection\u003c/code\u003e entities, indicates the certainty of election dates and is required for pre-election feeds.\u003c/p\u003e\n"],["\u003cp\u003eThis field uses enumerations like \u003ccode\u003econfirmed\u003c/code\u003e, \u003ccode\u003ecanceled\u003c/code\u003e, \u003ccode\u003epostponed\u003c/code\u003e, \u003ccode\u003etentative\u003c/code\u003e, and \u003ccode\u003echanging\u003c/code\u003e to describe the status of an election or contest's date.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003econfirmed\u003c/code\u003e indicates confirmed dates, while \u003ccode\u003ecanceled\u003c/code\u003e signifies cancellation, and \u003ccode\u003epostponed\u003c/code\u003e means delayed without a new date yet.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etentative\u003c/code\u003e implies the election or contest might not occur, while \u003ccode\u003echanging\u003c/code\u003e suggests a high likelihood of date changes.\u003c/p\u003e\n"],["\u003cp\u003eWhen an election is postponed and a new date is set, update the dates and revert \u003ccode\u003eElectionDateStatus\u003c/code\u003e to \u003ccode\u003econfirmed\u003c/code\u003e.\u003c/p\u003e\n"]]],[],null,["# DateStatus\n\n| **Note:** This enumeration is the same for the pre-election data and election results feed types. It isn't used with officeholder feeds. In pre-election feeds, this is a required field. If the date is known and not likely to change/cancel, use `confirmed` instead of leaving blank. See the definitions for each enum value.\n\nThe following table lists the enumerations for date status in the\n[`Contest`](/civics-data/reference/contest) and\n[`Election`](/civics-data/reference/election) entities:\n\n| Value | Description |\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `confirmed` | Used when the election dates are confirmed. |\n| `canceled` | Used when an election is canceled. |\n| `postponed` | Used if an election is postponed and no new date is set. If an election is postponed and no new date has been set, set the ElectionDateStatus to postponed and leave the original StartDate and EndDate in place. When a new date is set, update the dates and set the ElectionDateStatus back to confirmed. |\n| `tentative` | This usually reflects that the election or contest itself is at risk of not happening, and not its date specifically. For example, a round 2 election (date is known but the contest may or may not happen depending on round 1 results), or, a very low probability snap election. |\n| `changing` | The election or contest is likely to happen, but the date is highly likely to change. For example, a high probability snap election whose date is being speculated, or other regional factors leading to an actual change in an election's date. Use \\`changing\\` if an election has a high risk and it is unclear if it will result in just a changed date or a canceled date. |"]]