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" : "PUBLIC 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

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
  }
}