Hearing Transcripts API

Note

Most Assembly hearings are not available at this time.

Get a single Hearing

Usage

Retrieve hearing by id or filename

(GET) /api/3/hearings/{id}
(GET) /api/3/hearings/{filename}

Examples

Request hearing 5

/api/3/hearings/5

Request hearing “10-29-13 NYsenate_Flanagan_Education_FINAL.txt”

/api/3/hearings/10-29-13 NYsenate_Flanagan_Education_FINAL.txt

Response

Full Hearing Response

{
  "success" : true,                               // Indicates if a hearing was found.
  "message" : "Data for hearing 10-29..",  // Response description
  "responseType" : "hearing",                     // Response data type
  "result" : {
    "id": 179
    "filename" : "10-29-13 NYsenate_Flanagan..",  // Filename of hearing transcript
    "title" : "HEARING THE REGENTS RE..",  // Title of hearing
    "date" : "2013-10-29",                        // Date of hearing
    "address" : "Senate Hearing Room\n250 Br..",  // Address of hearing
    "committees" : [ {                            // List of committees/task forces/other groups holding the hearing
      "name" : "EDUCATION",                       // Name of committee/task force/other group
      "type" : "COMMITTEE"                        // Type of group, committee/task force/legislative commission/etc
      "chamber" : "SENATE"                        // Chamber of committee
    } ],
    "startTime" : "10:00",                        // Time the hearing started
    "endTime" : "14:00",                          // Time the hearing ended
    "text" : "\n\n\n       1     BEFORE THE NE.." // The text of the hearing
    }
}

Get a hearing pdf

Usage

Retrieve hearing pdf by id or filename

(GET) /api/3/hearings/{id}.pdf
(GET) /api/3/hearings/{filename}.pdf

Examples

Request hearing 09-12-13 NYSsenate_DeFrancisco_Buffalo_FINAL.txt

/api/3/hearings/09-12-13 NYSsenate_DeFrancisco_Buffalo_FINAL.txt.pdf

---

Get a list of hearings

Usage

List hearings within a year

(GET) /api/3/hearings/{year}

Optional Params

Parameter	Values	Description
limit	1 - 1000	Number of results to return
offset	> 1	Result number to start from
full	boolean	Set to true to see the full hearing responses.
sort	string	Sort by any field from the response.

Examples

List 50 hearings from 2014

/api/3/hearings/2014?limit=50

List 50 complete hearings starting from 51

/api/3/hearings/2014?limit=50%offset=51&full=true

List 10 complete hearings sorted by increasing date

/api/3/hearings/2014?limit=10&full=true&sort=dateTime:ASC

Response

{
  "success" : true,                               // True if request was fine.
  "message" : "",
  "responseType" : "hearing-id list",
  "total" : 451,                                  // Total hearings in the listing
  "offsetStart" : 1,                              // Offset value
  "offsetEnd" : 0,                                // To paginate, set query param offset = {offsetEnd + 1}
  "limit" : 10,                                   // Max number of results to show
  "result" : {
    "items": [{ ... }],                           // Array of hearing responses
    "size": 10
  }
}