Senate Floor Transcripts API¶
Note
Assembly transcripts are not available at this time.
Get a single Transcript¶
Usage
Retrieve transcript by dateTime and sessionType. The sessionType is only required if two transcripts have the same dateTime
(GET) /api/3/transcripts/{dateTime}
(GET) /api/3/transcripts/{dateTime}/{sessionType}
Examples
Request transcript 2014-09-03T09:00
/api/3/transcripts/2014-09-03T09:00
Response
Full Transcript Response
{
"success" : true, // Indicates if a transcript was found.
"message" : "Data for transcript 2014-09-03T09:00:00", // Response description.
"responseType" : "transcript", // Response data type.
"result" : {
"dateTime" : "2014-09-03T09:00", // The date and time of the session.
"sessionType" : "REGULAR SESSION", // Session type
"location" : "ALBANY, NEW YORK", // Location of senate session.
"text" : "5100\n\n 1 NEW YORK STATE SE.." // The text of the transcript.
}
}
Request the extraordinary session 3 transcript on 2010-12-31T10:00
/api/3/transcripts/2010-12-31T10:00/EXTRAORDINARY SESSION III
Response
Full Transcript Response
{
"success" : true,
"message" : "Data for transcript 2010-12-31T10:00",
"responseType" : "transcript",
"result" : {
"dateTime" : "2010-12-31T10:00",
"sessionType" : "EXTRAORDINARY SESSION III",
"location" : "ALBANY, NEW YORK",
"text" : "..."
}
}
Get a transcript pdf¶
Usage
Retrieve transcript pdf by dateTime. The sessionType is only required if two transcripts have the same dateTime
(GET) /api/3/transcripts/{dateTime}.pdf
(GET) /api/3/transcripts/{dateTime}/{sessionType}.pdf
Examples
Request transcript 2014-09-03T09:00
/api/3/transcripts/2014-09-03T09:00
Get a list of transcripts¶
Usage
List transcripts within a year
(GET) /api/3/transcripts/{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 transcript responses. |
sort |
string |
Sort by any field from the response. |
Examples
List 50 transcripts from 2014
/api/3/transcripts/2014?limit=50
List 50 complete transcripts starting from 51
/api/3/transcripts/2014?limit=50%offset=51&full=true
List 10 complete transcripts sorted by increasing date
/api/3/transcripts/2014?limit=10&full=true
Response
{
"success" : true, // True if request was fine.
"message" : "",
"responseType" : "transcript list",
"total" : 167, // Total transcripts 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 transcript responses
"size": 10
}
}