Skip to content

Members

Matt Farmer edited this page Aug 10, 2013 · 4 revisions

The Member resource provides information on individual Senators and Representatives. Many of these API calls are scoped to a particular session, and those that are will assume the current session if you don't provide one as an argument.

The Member Model

Field Description
_id The unique ID of the member in the API database.
assemblyId The ID of the person on the General Assembly website.
type The type of the member in the General Assembly.
firstName The first name of the member.
middleName The middle name of the member.
lastName The last name of the member.
nickname The nickname of the member.
party A letter indicating the party of the individual. "R" for Republican, "D" for Democrat, and so on.
district The district number the member represents.
city The city the person represents.
capitolAddress Capitol Address, if provided.
districtAddress District Address, if provided.
photoUri URI of the persons photo.
sessions An array of session ID's where this person has been active.

GET /api/v1/members

This API call will retrieve a list of members active in the current session, unless a sessionId query parameter is provided with the ID of a different session. That list will be a JSON array of JSON objects that contain the unique ID of the member, the display name, the party, and the photoUri. For example...

[
  {"_id": "abcabc", "displayName": "Bacon Sammich", "party": "D", "photoUri": "http://bacoon.sammich/photo.gif"},
  {"_id": "defdef", "displayName": "Ham Sammich", "party": "R", "photoUri": "http://ham.sammich/photo.gif"}
]

GET /api/v1/member/:id

This API call will retrieve the full descriptive object outlined in the model above for a particular representative or senator. In the event you provide an invalid ID, you'll get a 404 response.

GET /api/v1/member/:id/votes

This API call will retrieve a JSON object of the votes this member has recorded, keyed on what they voted, with values being an array of vote IDs:

{
  "yea": ["voteid1", "voteid2", "voteid3"],
  "nay": ["voteid4", "voteid5", "voteid6"],
  "nv": ["voteid7"],
  "exc": ["voteid8", "voteid9"]
}

The strings above will be the unique IDs of vote objects. In the event no matching votes are found, a 204 will be returned. To retrieve a list of votes from a different session, provide a sessionId query parameter with the session ID.

Clone this wiki locally