openapi: 3.0.3
info:
title: FVAP.gov XML Ballot Rules Important Info API
description: The Federal Voting Assistance Program (FVAP) publishes XML feeds providing voter information by U.S. state and territory. Each jurisdiction exposes four datasets covering important info, deadline dates, ballot rules, and election offices, plus a combined electronic Voting Assistance Guide (eVAG).
version: 1.0.0
contact:
name: FVAP
url: https://www.fvap.gov/
license:
name: Public Domain (U.S. Federal Government)
url: https://www.usa.gov/government-works
servers:
- url: https://www.fvap.gov
description: FVAP production
tags:
- name: Important Info
description: General voting information for a jurisdiction.
paths:
/xml-api/{state}/important-info.xml:
get:
tags:
- Important Info
summary: Get important voting information for a state or territory.
description: Returns the FAQ-style important voting information XML feed for the specified jurisdiction.
operationId: getImportantInfo
parameters:
- $ref: '#/components/parameters/State'
responses:
'200':
description: Important info XML feed.
content:
application/xml:
schema:
$ref: '#/components/schemas/ImportantInfo'
components:
schemas:
ImportantInfo:
type: object
description: FAQ-style important voting information.
properties:
questions:
type: array
items:
type: object
properties:
question:
type: string
answer:
type: string
parameters:
State:
name: state
in: path
required: true
description: U.S. state, district, or territory name (PascalCase, e.g. Alabama, NewYork, PuertoRico, DistrictOfColumbia).
schema:
type: string