Senate Members API

Get a single Member

Usage

Retrieve member by session year and member id

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

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 member id 371 during 2013 session year.

/api/3/members/2013/371

Sample Response

{
  "success": true,
  "message": "",
  "responseType": "member-sessions",
  "result": {
    "memberId": 371,
    "chamber": "SENATE",                  // Chamber of service
    "incumbent": true,                    // Whether the member is currently serving
    "fullName": "James L. Seward",
    "shortName": "SEWARD",
    "service": {
      "sessionYearsServed": [             // Sorted list of session years served
        2009,
        2011,
        2013,
        2015
        ]
    },
    "sessionShortNameMap": {
      "2009": [
        {
          "sessionMemberId": 3,
          "shortName": "SEWARD",
          "sessionYear": 2009,
          "districtCode": 51,
          "alternate": false,
          "memberId": 371
        }
      ],
      "2011": [
        {
          "sessionMemberId": 65,
          "shortName": "SEWARD",
          "sessionYear": 2011,
          "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

List all currently serving members for session year 2025

/api/3/members/2025/search?term=incumbent:true