office

Office represents the office associated with a contest or district (e.g. Alderman, Mayor, School Board, et al).

Tag Data Type Required? Repeats? Description Error Handling
contact_information_id xs:IDREF Optional Repeats Links to the contact_information element associated with the office. If the element is invalid or not present, then the implementation is required to ignore it.
description xs:string Optional Single A brief description of the office and its purpose. If the element is invalid or not present, then the implementation is required to ignore it.
electoral_district_id xs:IDREF Required Single Links to the electoral_district element associated with the office. If the field is invalid or not present, the implementation is required to ignore the Office element containing it.
external_identifiers xs:IDREF Optional Single Other identifiers that link this office to other related datasets (e.g. campaign finance systems, OCD IDs, et al.). If the element is invalid or not present, then the implementation is required to ignore it.
filing_deadline xs:date Optional Single Specifies the date and time when a candidate must have filed for the contest for the office. If the field is invalid or not present, then the implementation is required to ignore it.
is_partisan xs:boolean Optional Single Indicates whether the office is partisan. If the field is invalid or not present, then the implementation is required to ignore it.
name xs:string Required Single The name of the office. If the field is invalid or not present, the implementation is required to ignore the Office element containing it.
office_holder_person_ids xs:IDREFS Optional Single Links to the person element(s) that hold additional information about the current office holder(s). If the field is invalid or not present, then the implementation is required to ignore it.
term term Optional Single Defines the term the office can be held. If the element is invalid or not present, then the implementation is required to ignore it.
1
2
3
4
 id,electoral_district_id,external_identifier_type,external_identifier_othertype,external_identifier_value,filing_deadline,is_partisan,name,office_holder_person_ids,term_type,term_start_date,term_end_date
 off001,ed001,,,,,true,Deputy Chief of Staff,per50003,full-term,2002-01-21,
 off002,ed001,,,,,true,Deputy Deputy Chief of Staff,per50001,unexpired-term,2002-01-21,
 off003,ed001,,,,,false,General Secretary of Secretaries,per50004,full-term,2002-01-21,

term

Tag Data Type Required? Repeats? Description Error Handling
term_type office_term_type Optional Single Specifies the type of office term (see office_term_type for valid values). If the field is invalid or not present, the implementation is required to ignore the Office element containing it.
term_start_date xs:date Optional Single Specifies the start date for the current term of the office. If the field is invalid or not present, then the implementation is required to ignore it.
term_end_date xs:date Optional Single Specifies the end date for the current term of the office. If the field is invalid or not present, then the implementation is required to ignore it.

contact_information

For defining contact information about objects such as persons, boards of authorities, organizations, etc. ContactInformation is always a sub-element of another object (e.g. election_administration, office, person, source). ContactInformation has an optional attribute label, which allows the feed to refer back to the original label for the information (e.g. if the contact information came from a CSV, label may refer to a row ID).

Tag Data Type Required? Repeats? Description Error Handling
address_line xs:string Optional Repeats The “location” portion of a mailing address. See usage note. If the field is invalid or not present, then the implementation is required to ignore it.
directions xs:string Optional Single Specifies further instructions for locating this entity. If the element is invalid or not present, then the implementation is required to ignore it.
email xs:string Optional Repeats An email address for the contact. If the field is invalid or not present, then the implementation is required to ignore it.
fax xs:string Optional Repeats A fax line for the contact. If the field is invalid or not present, then the implementation is required to ignore it.
hours xs:string Optional Single Contains the hours (in local time) that the location is open (NB: this element is deprecated in favor of the more structured :ref:`multi-csv-hours-open` element. It is strongly encouraged that data providers move toward contributing hours in this format). If the element is invalid or not present, then the implementation is required to ignore it.
hours_open_id xs:IDREF Optional Single References an hours_open element, which lists the hours of operation for a location. If the field is invalid or not present, then the implementation is required to ignore it.
lat_long lat_long Optional Single Specifies the latitude and longitude of this entity. If the element is invalid or not present, then the implementation is required to ignore it.
name xs:string Optional Single The name of the location or contact. See usage note. If the field is invalid or not present, then the implementation is required to ignore it.
phone xs:string Optional Repeats A phone number for the contact. If the field is invalid or not present, then the implementation is required to ignore it.
uri xs:anyURI Optional Repeats An informational URI for the contact or location. If the field is invalid or not present, then the implementation is required to ignore it.
1
2
3
 id,address_line_1,address_line_2,address_line_3,directions,email,fax,hours,hours_open_id,latitude,longitude,latlng_source,name,phone,uri,parent_id
 ci0827,The White House,1600 Pennsylvania Ave,,,josh@example.com,,Early to very late,,,,,Josh Lyman,555-111-2222,http://lemonlyman.example.com,off001
 ci0828,The White House,1600 Pennsylvania Ave,,,josh@example.com,,Early to very late,,,,,Josh Lyman,555-111-2222,http://lemonlyman.example.com,vs01