Vote Objects

Warning

Parts of Open Civic Data underwent a large refactor as of mid-2014, some information on this page may be out of date. We’re working on updating this documentation as soon as possible.

We’ll remove these messages from pages as they’re updated and vetted.

Vote objects have the following fields:

Basic Fields

organization (string, null)
name of the voting organization (required)
organization_id (string, null)
id of the voting organization (required)
_type (string)

All vote objects must have a _type field set to vote. (required)

Allowed values:
  • vote
session (string)
Associated with one of the jurisdiction’s sessions (required)
chamber (string, null)

chamber vote took place in (if legislature is bicameral, otherwise null) (required)

Allowed values:
  • upper
  • lower
  • joint
date (string)

date of the action (required)

(must match format: ^[0-9]{4}(-[0-9]{2}){0,2}$)

motion (string)
description of motion (from upstream source) (required)
type (array)

array of types (required, minItems: 0)

Each element in type is of type (string)
Allowed values:
  • bill-passage
  • amendment-passage
  • veto-override
passed (boolean)
boolean indicating if vote passed (required)

Common Fields

updated_at (string, datetime)
the time that the object was last updated
created_at (string, datetime)
the time that this object was first created
sources (array)

URLs for sources relating to the object (required, minItems: 1)

Each element in sources is an object with the following keys:

url (string)
URL of resource used to collect information (required)
note (null, string)
note about what information this URL was used for (required)

Relationship to Bill

bill (object, null)

Related bill, votes will have a non-null bill object ifthey are related to a bill. Bills will have the following fields: (required)

chamber (string, null)

bill’s chamber if vote was on a bill (and legislature is bicameral, otherwise null) (required)

Allowed values:
  • upper
  • lower
id (string, null)
bill’s internal id if bill was matched with an object in the database (required)
name (string)
bill name (e.g. HB 21) (required)

Vote Counts

vote_counts (**)

list of objects with vote_type and count properties (required)

Each element in vote_counts is an object with the following keys:

count (integer)

number of people voting this way (required)

(minimum value: 0)

vote_type (string)

(e.g. yes, no, not-voting) (required)

Allowed values:
  • yes
  • no
  • absent
  • abstain
  • not voting
  • paired
  • excused
  • other
roll_call (**)

list of individual legislator votes (required)

Each element in roll_call is an object with the following keys:

person (object)

person object representing the voter (required)

name (string)
person’s name as provided by the source (required)
id (string, null)
person’s internal id if they’ve been matched to an entity in the database (required)
vote_type (string)

(e.g. yes, no, not-voting) (required)

Allowed values:
  • yes
  • no
  • absent
  • abstain
  • not voting
  • paired
  • excused
  • other
Read the Docs v: latest
Versions
latest
Downloads
pdf
htmlzip
epub
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.