Senate Members API

Get a single Member

Usage

Retrieve member by session year and member id

(GET) /api/3/members/{sessionYear}/{id}

Optional Params

Parameter	Values	Description
full	boolean	(default true) Set to true to get a full member response instead of a summary.

Examples

Get member with id 371 during 2013 session year.

/api/3/members/2013/371

Sample Response

{
  "success" : true,
  "message" : "",
  "responseType" : "member-sessions",
  "result" : {
    "memberId" : 371,
    "chamber" : "SENATE",
    "incumbent" : true,
    "fullName" : "James L. Seward",
    "shortName" : "SEWARD",
    "sessionShortNameMap" : {
      "2013" : [ {
        "sessionMemberId" : 127,
        "shortName" : "SEWARD",
        "sessionYear" : 2013,
        "districtCode" : 51,
        "alternate" : false,
        "memberId" : 371
      } ]
    },
    "person" : {
      "personId" : 190,
      "fullName" : "James L. Seward",
      "firstName" : "James",
      "middleName" : "L.",
      "lastName" : "Seward",
      "email" : "seward@senate.state.ny.us",
      "prefix" : "Senator",
      "suffix" : null,
      "verified" : true,
      "imgName" : "371_james_l._seward.jpg"
    }
  }
}

Get a list of members

Usage

List members for a session year.

(GET) /api/3/members/{sessionYear}

List members in a chamber for a session year

(GET) /api/3/members/{sessionYear}/{chamber}

Optional Params

Parameter	Values	Description
limit	1 - 1000	(default = 50) Number of results to return
offset	> 1	(default = 1) Result number to start from
full	boolean	(default = false) Set to true to see the full member responses.
sort	string	(default = shortName:asc) Sort by any field from the response.

Examples

List all members from session year 2013

/api/3/members/2013

List full member info for session members during session year 2011. Limit to 5 results.

/api/3/members/2011/senate?full=true&limit=5

Search for members

Read our search API docs for info on how to construct search terms.

Usage

Search across all session years

(GET) /api/3/members/search?term=YOUR_TERM

Search within a session year

(GET) /api/3/members/{sessionYear}/search?term=YOUR_TERM

Note: given a sessionMemberId = #### in a session year yyyy, you can get the member that sessionMemberId is used by with:

(GET) /api/3/members/search?term=sessionShortNameMap.yyyy.sessionMemberId=####

Required Params

Parameter	Values	Description
term	string	ElasticSearch query string

Optional Params

Parameter	Values	Description
limit	1 - 1000	(default = 50) Number of results to return
offset	> 1	(default = 1) Result number to start from
full	boolean	(default = false) Set to true to see the full member responses.
sort	string	(default = “”) Sort by any field from the response.

Examples

List all members who have served district code 20

/api/3/members/search?term=districtCode:20