V2 API Collaboration

This wiki page serves as a collaborative workspace for considering revisions to the Open States API.

The contents below do not reflect reality, yet. This is only for collaborative discussion.

---

/api/v2/states

[
  {
    "id": "ak",
    "feature_flags": [
      "subjects"
    ],
    "name": "Alaska",
    "level": "state"
   },
  {
    "id": "az",
    "feature_flags": [],
    "name": "Arizona",
    "level": "state"
  }
]

/api/v2/states/tx

{
  "id": "tx",
  "name": "Texas",
  "level": "state",
  "legislature_name": "Texas Legislature",
  "chambers": [
    "upper": {
      "chamber_id": "TXCM01",
      "name": "Senate",
      "term": 4,
      "title": "Senator"
    },
    "lower": {
      "chamber_id": "TXCM02",
      "name": "House of Representatives",
      "term": 2,
      "title": "Representative"
    }
  ],
  "feature_flags": [
    "events",
    "subjects"
  ],
  "terms": [
    {
      "end_year": 2010,
      "start_year": 2009,
      "name": "81",
      "+type": "primary",
      "sessions": [
        "81",
        "811"
      ]
    },
    {
      "end_year": 2012,
      "start_year": 2011,
      "name": "82",
      "sessions": [
        "82",
        "821"
      ]
    }
  ],
  "latest_csv_url": "http://data.openstates.sunlightlabs.com.s3.amazonaws.com/2011-10-01-tx-csv.zip",
  "latest_dump_date": "2011-10-01 18:58:30",
  "latest_update": "2011-09-27 16:51:27",
  "latest_dump_url": "http://data.openstates.sunlightlabs.com.s3.amazonaws.com/2011-10-01-tx.zip",
  "latest_csv_date": "2011-10-01 09:04:21",
  "session_details": {
    "82": {
      "type": "primary",
      "display_name": "82nd Legislature",
      "start_date": "2011-01-11 00:00:00"
    },
    "811": {
      "type": "special",
      "display_name": "81st Legislature, 1st Called Session",
      "start_date": "2009-07-01 00:00:00",
      "end_date": "2009-07-10 00:00:00"
    },
    "81": {
      "type": "primary",
      "display_name": "81st Legislature",
      "start_date": "2009-01-13 00:00:00",
      "end_date": "2009-06-01 00:00:00"
    },
    "821": {
      "type": "special",
      "display_name": "82nd Legislature, 1st Called Session"
    }
  }
}

/api/v2/legislators/ut

/api/v2/legislators/ut?chamber_name=upper (search based on keyed property values)

/api/v2/legislators/ut?district_id=UTD000022 (search based on keyed property values)

[
  {
    "id": "UTL000001",
    "state_id": "ut",
    "active": true,
    "chamber_name": "upper",
    "chamber_id": "UTCM01",
    "first_name": "J. Stuart",
    "middle_name": "",
    "last_name": "Adams",
    "suffixes": "",
    "full_name": "J. Stuart Adams",
    "district_name": "22",
    "district_id": "UTD000022",
    "party": "Republican",
    "photo_url": "http://www.utahsenate.org/images/member-photos/ADAMSJS.jpg",
    "votesmart_id": "50400",
    "transparencydata_id": "7550a6b5867547f9b52f418a4e59a202",
    "emails": [
      "jsadams@utahsenate.org",
      "campaign@votejstewart.com"
    ],
    "created_at": "2011-01-14 22:24:08",
    "updated_at": "2011-10-24 02:53:40",
  }
]

/api/v2/legislators/UTL000001

{
  "id": "UTL000001",
  "state_id": "ut",
  "active": true,
  "chamber_name": "upper",
  "chamber_id": "UTCM01",
  "first_name": "J. Stuart",
  "middle_name": "",
  "last_name": "Adams",
  "suffixes": "",
  "full_name": "J. Stuart Adams",
  "district_name": "22",
  "district_id": "UTD000022",
  "party": "Republican",
  "photo_url": "http://www.utahsenate.org/images/member-photos/ADAMSJS.jpg",
  "votesmart_id": "50400",
  "transparencydata_id": "7550a6b5867547f9b52f418a4e59a202",
  "emails": [
    "jsadams@utahsenate.org",
    "campaign@votejstewart.com"
  ],
  "websites": [
    "http://www.utahsenate.org/aspx/senmember.aspx?dist=22",
    "http://www.votejstewart.com"
  ],
  "created_at": "2011-01-14 22:24:08",
  "updated_at": "2011-10-24 02:53:40",
  "sources": [
    "http://www.utahsenate.org/aspx/roster.aspx",
    "http://www.utahsenate.org/aspx/senmember.aspx?dist=22"
  ],
  "old_roles": {},
  "roles": [
    {
      "term": "2011-2012",
      "end_date": null,
      "district_name": "22",
      "level": "state",
      "country": "us",
      "chamber_name": "upper",
      "chamber_id": "UTCM01",
      "state_id": "ut",
      "party": "Republican",
      "type": "member",
      "start_date": null
    }
  ],
  "committees": [
    {
      "term": "2011-2012",
      "committee_id": "UTC000009",
      "chamber_name": "upper",
      "chamber_id": "UTCM01",
      "state_id": "ut",
      "subcommittee": null,
      "name": "Revenue and Taxation Committee",
      "type": "member"
    },
    {
      "term": "2011-2012",
      "committee_id": "UTC000011",
      "name": "Transportation and Public Utilities and Technology Committee",
      "type": "member",
      "chamber_name": "upper",
      "chamber_id": "UTCM01",
      "state_id": "ut",
      "subcommittee": null
    }
  ],
  "offices": [
    {
      "office_id": "UTO000002",
      "leg_id": "UTL000001",
      "type": "capitol",
      "state_id": "ut",
      "phone": "(404) 656-0202",
      "fax": "(404) 656-0203",
      "address": "111 Broadway\n Salt Lake City,\n Utah 33112",
      "coordinates": [
        -32.123123,
        101.2212
      ]
    },
    {
      "office_id": "UTO000003",
      "leg_id": "UTL000001",
      "state_id": "ut",
      "type": "district",
      "phone": "(404) 555-1212",
      "fax": null,
      "address": "88 Main St\n Provo,\n Utah 34123",
      "coordinates": [
        -7.32,
        72.444
      ]
    }
  ]
}