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": {
      "name": "Senate",
      "term": 4,
      "title": "Senator"
    },
    "lower": {
      "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"
    }
  }
}