NOTICE: Due to a lapse in annual appropriations, most of this website is not being updated. Learn more.
Form submissions will still be accepted but will not receive responses at this time. Sections of this site for programs using non-appropriated funds (such as NVLAP) or those that are excepted from the shutdown (such as CHIPS and NVD) will continue to be updated.
An official website of the United States government
Here’s how you know
Official websites use .gov
A .gov website belongs to an official government organization in the United States.
Secure .gov websites use HTTPS
A lock (
) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.
Ballot Definition Common Data Format Specification
Published
Author(s)
Benjamin Long, John Dziurłaj
Abstract
This publication describes a ballot definition common data format for the interchange of logical and physical ballot style information. It contains a UML (Unified Modeling Language) model of the election data and a JSON (JavaScript Object Notation) and XML (eXtensible Markup Language) format derived from the UML model. It contains background information regarding how geopolitical geography is structured and used in the model and schemas. It also provides usage examples for anticipated use-cases. The format is comprehensive and at the same time very flexible, able to accommodate election scenarios used throughout the U.S. It is part of a series of common data format specifications for voting equipment.
Common data format (CDF), ballot definition (BD), ballot style, JavaScript Object Notation (JSON), unified markup language (UML), eXtensible Markup Language (XML).
Long, B.
and Dziurłaj, J.
(2023),
Ballot Definition Common Data Format Specification, Special Publication (NIST SP), National Institute of Standards and Technology, Gaithersburg, MD, [online], https://doi.org/10.6028/NIST.SP.1500-20, https://tsapps.nist.gov/publication/get_pdf.cfm?pub_id=936145
(Accessed October 8, 2025)