Legislators

Warning

API v1 is deprecated, please check out API v3 or API v2 both of which are actively supported.

Legislator Search
Search legislators by their attributes.
Legislator Detail
Get full detail for a legislator, including all roles.
Geo Lookup
Lookup all legislators that serve districts containing a given point.

Legislator Fields

The following fields are available on legislator objects:

  • leg_id Legislator’s permanent Open States ID. (e.g. ‘ILL000555’, ‘NCL000123’)
  • state Legislator’s state.
  • active Boolean value indicating whether or not the legislator is currently in office.
  • chamber Chamber the legislator is currently serving in if active (‘upper’ or ‘lower’)
  • district District the legislator is currently serving in if active (e.g. ‘7’, ‘6A’)
  • party Party the legislator is currently representing if active.
  • email Legislator’s primary email address.
  • full_name Full display name for legislator.
  • first_name First name of legislator.
  • middle_name Middle name of legislator.
  • last_name Last name of legislator.
  • suffixes Name suffixes (e.g. ‘Jr.’, ‘III’) of legislator.
  • photo_url URL of an official photo of this legislator.
  • url URL of an official webpage for this legislator.
  • created_at The date that this object first appeared in our system.
  • updated_at The date that this object was last updated in our system.
  • created_at Date at which this legislator was added to our system.
  • updated_at Date at which this legislator was last updated.
  • offices List of office objects representing contact details for the legislator. Comprised of the following fields:
    • type ‘capitol’ or ‘district’
    • name Name of the address (e.g. ‘Council Office’, ‘District Office’)
    • address Street address.
    • phone Phone number.
    • fax Fax number.
    • email Email address. Any of these fields may be ``null`` if not found.
  • roles List of currently active role objects if legislator is in office.
  • old_roles Dictionary mapping term keys to lists of roles that were valid for that term.

Roles

roles and old_roles are comprised of role objects.

Role objects can have the following fields:

  • term Term key for this role. (See metadata notes on terms and sessions for details.)
  • chamber
  • state
  • start_date (optional)
  • end_date (optional)
  • type ‘member’ or ‘committee member’

If the role type is ‘member’:

  • party
  • district

And if the type is ‘committee member’:

  • committee name of parent committee
  • subcommittee name of subcommittee (if null, membership is just for a committee)
  • committee_id Open States id for committee that legislator is a member of
  • position position on committee
  • old_roles
  • sources List of URLs used in gathering information for this legislator.

Methods

Legislator Detail

This method returns the full detail for a legislator.

Example: openstates.org/api/v1/legislators/DCL000012/

Geo Lookup

Lookup all legislators serving districts containing a given location.

Example: openstates.org/api/v1/legislators/geo/?lat=35.79&long=-78.78

Examples

Legislator Detail

openstates.org/api/v1/legislators/DCL000012/

{
 "active": true,
 "chamber": "upper",
 "created_at": "2011-02-17 22:43:55",
 "district": "Ward 8",
 "email": "mbarry@dccouncil.us",
 "first_name": "Marion",
 "full_name": "Marion Barry",
 "id": "DCL000012",
 "last_name": "Barry",
 "leg_id": "DCL000012",
 "level": "state",
 "middle_name": "",
 "office_address": "1350 Pennsylvania Avenue NW, Suite 102, Washington, DC 20004",
 "offices": [
  {
   "fax": "(202) 724-8055",
   "name": "Council Office",
   "phone": "(202) 724-8045",
   "address": "1350 Pennsylvania Avenue NW, Suite 102, Washington, DC 20004",
   "type": "capitol",
   "email": null
  }
 ],
 "old_roles": {
  "2011-2012": [
   {
    "term": "2011-2012",
    "end_date": null,
    "district": "Ward 8",
    "chamber": "upper",
    "state": "dc",
    "party": "Democratic",
    "type": "member",
    "start_date": null
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000017",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "Finance and Revenue",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000027",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "Jobs and Workforce Development",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000021",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "the Judiciary",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000019",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "Aging and Community Affairs",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000026",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "Economic Development and Housing",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000014",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "Human Services",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2011-2012",
    "committee_id": "DCC000023",
    "chamber": "upper",
    "state": "dc",
    "subcommittee": null,
    "committee": "Health",
    "position": "member",
    "type": "committee member"
   }
  ]
 },
 "party": "Democratic",
 "photo_url": "http://dccouncil.us/files/user_uploads/member_photos/barry.jpg",
 "roles": [
  {
   "term": "2013-2014",
   "end_date": null,
   "district": "Ward 8",
   "chamber": "upper",
   "state": "dc",
   "party": "Democratic",
   "type": "member",
   "start_date": null
  },
  {
   "term": "2013-2014",
   "committee_id": "DCC000014",
   "chamber": "upper",
   "state": "dc",
   "subcommittee": null,
   "committee": "Human Services",
   "position": "member",
   "type": "committee member"
  },
  {
   "term": "2013-2014",
   "committee_id": "DCC000017",
   "chamber": "upper",
   "state": "dc",
   "subcommittee": null,
   "committee": "Finance and Revenue",
   "position": "member",
   "type": "committee member"
  },
  {
   "term": "2013-2014",
   "committee_id": "DCC000032",
   "chamber": "upper",
   "state": "dc",
   "subcommittee": null,
   "committee": "Education",
   "position": "member",
   "type": "committee member"
  },
  {
   "term": "2013-2014",
   "committee_id": "DCC000031",
   "chamber": "upper",
   "state": "dc",
   "subcommittee": null,
   "committee": "Workforce and Community Affairs",
   "position": "member",
   "type": "committee member"
  }
 ],
 "sources": [ { "url": "http://dccouncil.us/council/marion-barry" } ],
 "state": "dc",
 "suffixes": "",
 "updated_at": "2013-03-26 03:22:24",
 "url": "http://dccouncil.us/council/marion-barry",
 "votesmart_id": "72074"
}

Geo Lookup

openstates.org/api/v1/legislators/geo/?lat=35.79&long=-78.78

[
 {
  "last_name": "Stein",
  "suffix": "",
  "updated_at": "2013-03-27 02:35:39",
  "sources": [ { "url": "http://www.ncga.state.nc.us/gascripts/members/viewMember.pl?sChamber=Senate&nUserID=267" } ],
  "full_name": "Josh Stein",
  "old_roles": {
   "2009-2010": [
    {
     "term": "2009-2010",
     "end_date": null,
     "district": "16",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "party": "Democratic",
     "type": "member",
     "start_date": null
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000002",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Appropriations on Department of Transportation",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000008",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Appropriations/Base Budget",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000009",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Commerce",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000010",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Education/Higher Education",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000073",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Finance",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000012",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Health Care",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000074",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Judiciary I",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000022",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Select Committee on Economic Recovery",
     "type": "committee member"
    },
    {
     "term": "2009-2010",
     "committee_id": "NCC000024",
     "level": "state",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Select Committee on Energy, Science and Technology",
     "type": "committee member"
    }
   ],
   "2011-2012": [
    {
     "term": "2011-2012",
     "end_date": null,
     "district": "16",
     "chamber": "upper",
     "state": "nc",
     "party": "Democratic",
     "type": "member",
     "start_date": null
    },
    {
     "term": "2011-2012",
     "committee_id": "NCC000009",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Commerce",
     "position": "member",
     "type": "committee member"
    },
    {
     "term": "2011-2012",
     "committee_id": "NCC000100",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Education / Higher Education",
     "position": "member",
     "type": "committee member"
    },
    {
     "term": "2011-2012",
     "committee_id": "NCC000073",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Finance",
     "position": "member",
     "type": "committee member"
    },
    {
     "term": "2011-2012",
     "committee_id": "NCC000074",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Judiciary I",
     "position": "member",
     "type": "committee member"
    },
    {
     "term": "2011-2012",
     "committee_id": "NCC000018",
     "chamber": "upper",
     "state": "nc",
     "subcommittee": null,
     "committee": "Rules and Operations of the Senate",
     "position": "member",
     "type": "committee member"
    }
   ]
  },
  "id": "NCL000047",
  "first_name": "Josh",
  "middle_name": "",
  "district": "16",
  "state": "nc",
  "votesmart_id": "102971",
  "party": "Democratic",
  "email": "Josh.Stein@ncleg.net",
  "leg_id": "NCL000047",
  "boundary_id": "sldu/nc-16",
  "active": true,
  "transparencydata_id": "d3917a35b626477a9a7afaf7dbf206be",
  "photo_url": "http://www.ncga.state.nc.us/Senate/pictures/hiRes/267.jpg",
  "roles": [
   {
    "term": "2013-2014",
    "end_date": null,
    "district": "16",
    "chamber": "upper",
    "state": "nc",
    "party": "Democratic",
    "type": "member",
    "start_date": null
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000009",
    "chamber": "upper",
    "state": "nc",
    "subcommittee": null,
    "committee": "Commerce",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000100",
    "chamber": "upper",
    "state": "nc",
    "subcommittee": null,
    "committee": "Education / Higher Education",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000073",
    "chamber": "upper",
    "state": "nc",
    "subcommittee": null,
    "committee": "Finance",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000012",
    "chamber": "upper",
    "state": "nc",
    "subcommittee": null,
    "committee": "Health Care",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000074",
    "chamber": "upper",
    "state": "nc",
    "subcommittee": null,
    "committee": "Judiciary I",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000018",
    "chamber": "upper",
    "state": "nc",
    "subcommittee": null,
    "committee": "Rules and Operations of the Senate",
    "position": "member",
    "type": "committee member"
   }
  ],
  "level": "state",
  "url": "http://www.ncga.state.nc.us/gascripts/members/viewMember.pl?sChamber=Senate&nUserID=267",
  "created_at": "2010-08-03 17:14:46",
  "nimsp_id": "9383",
  "chamber": "upper",
  "offices": [
   {
    "fax": null,
    "name": "Capitol Office",
    "phone": "(919) 715-6400",
    "address": "NC Senate\n16 W. Jones Street, Room 1113\n\nRaleigh, NC 27601-2808",
    "type": "capitol",
    "email": null
   }
  ],
  "suffixes": ""
 },
 {
  "last_name": "Hall",
  "updated_at": "2013-03-27 02:35:42",
  "sources": [
   {
    "url": "http://www.ncga.state.nc.us/gascripts/members/viewMember.pl?sChamber=House&nUserID=679"
   }
  ],
  "full_name": "Duane Hall",
  "id": "NCL000282",
  "first_name": "Duane",
  "middle_name": "",
  "district": "11",
  "state": "nc",
  "party": "Democratic",
  "email": "Duane.Hall@ncleg.net",
  "leg_id": "NCL000282",
  "boundary_id": "sldl/nc-11",
  "+notice": null,
  "transparencydata_id": "07eff70ee51441d093b33667a2a6f877",
  "active": true,
  "photo_url": "http://www.ncga.state.nc.us/House/pictures/hiRes/679.jpg",
  "roles": [
   {
    "term": "2013-2014",
    "end_date": null,
    "district": "11",
    "chamber": "lower",
    "state": "nc",
    "party": "Democratic",
    "type": "member",
    "start_date": null
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000028",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Appropriations",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000035",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Appropriations Subcommittee on Transportation",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000082",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Commerce and Job Development",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000178",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Commerce and Job Development Subcommittee on Alcoholic Beverage Control",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000168",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Elections",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000088",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Government",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000107",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Homeland Security, Military, and Veterans Affairs",
    "position": "member",
    "type": "committee member"
   },
   {
    "term": "2013-2014",
    "committee_id": "NCC000172",
    "chamber": "lower",
    "state": "nc",
    "subcommittee": null,
    "committee": "Public Utilities and Energy",
    "position": "member",
    "type": "committee member"
   }
  ],
  "url": "http://www.ncga.state.nc.us/gascripts/members/viewMember.pl?sChamber=House&nUserID=679",
  "created_at": "2013-01-03 19:15:14",
  "chamber": "lower",
  "offices": [
   {
    "fax": null,
    "name": "Capitol Office",
    "phone": "919-733-5755",
    "address": "NC House of Representatives\n16 W. Jones Street, Room 1019\n\nRaleigh, NC 27601-1096",
    "type": "capitol",
    "email": null
   }
  ],
  "suffixes": ""
 }
]