Senate Agenda API¶
Committee Agendas are a collection of legislative meetings that take place to discuss bills and ultimately pass them to the floor.
The committee agendas for a given week are contained within a collection known as the weekly agenda. The weekly agenda starts at 1 for the first week, and increments by 1 for every subsequent week. The numbering of the agendas resets at the start of every year. Therefore a weekly agenda can be uniquely identified using the Agenda No and a Year.
Get a single agenda¶
Usage
Retrieve an agenda by year and agenda no
(GET) /api/3/agendas/{year}/{agendaNo}
Examples
Request agenda 2 of session year 2017
/api/3/agendas/2017/2
Note
Agenda responses have a lot of data. They contain their own data as well as bill data. The example, agenda 2 has over 10,000 lines.
Get a list of agendas for a single year¶
Usage
Returns a list of agenda ids in ascending order that occur in the given year
(GET) /api/3/agendas/{year}
Examples
- ::
/api/3/agendas/2017
Get a specific committee with an agenda¶
Usage
Retrieve a specific committee within an agenda
/api/3/agendas/{year}/{agendaNo}/{committeeName}
Examples
Request the Rules committee agenda 2 of session year 2017
/api/3/agendas/2017/2/Rules
Get a list of committee meeting times in a time range¶
Usage
Retrieve a list of committee meetings between from and to date/time, ordered by earliest first
(GET) /api/3/agendas/meetings/{from datetime}/{to datetime}
Examples
Retrieve a list of committee meetings between Jan 1st, 2017 to Feb 1st, 2017
/api/3/agendas/meetings/2017-01-01/2017-02-01
Search an Agenda for a term¶
Usage
Search agendas across all years for a term
(GET) /api/3/agendas/search
Note
The param term is required and the value of this parameter is whatever you are looking to find
Optional Params
Parameter |
Values |
|---|---|
full |
‘true’, ‘false’ |
limit |
Limit the number of results |
offset |
Start the results from offset |
sort |
A lucene sort string |
Examples
Search agendas for the term crime
/api/3/agendas/search?term=crime&full=false
Search all agendas in a calendar year for a term¶
Usage
Search agendas across all years for a term
(GET) /api/3/agendas/{year}/search
Note
The param term is required and the value of this parameter is whatever you are looking to find
Optional Params
Parameter |
Values |
|---|---|
full |
‘true’, ‘false’ |
limit |
Limit the number of results |
offset |
Start the results from offset |
sort |
A lucene sort string |
Examples
Search agendas for a specific term
/api/3/agendas/2017/search?term=crime&full=false&limit=10&offset=5
Get updated agenda Id’s¶
Warning
The following api calls work (by default) on the process date time. If we reprocess our data, the timestamps listed may not produce the same results. You can use the published date time to get updates from an earlier time
Usage
Return a list of agenda ids that have changed during a specified date/time range
(GET) /api/3/agendas/updates/
Note
This api call gets updates in the last 7 days
Usage
Get updates from the time specified to now
(GET) /api/3/agendas/updates/{from}
Examples
Get updates for all of the 2017 session
/api/3/agendas/updates/2017-01-01/
Usage
Get updates for a specified time range
(GET) /api/3/agendas/updates/{from}/{to}
Examples
Get updates for all of January 2018
/api/3/agendas/updates/2018-01-01/2018-01-31
Get updated agenda digests¶
Usage
This api call gets all digests for an agenda in a calendar year
(GET) /api/3/agendas/{year}/{agendaNo}/updates
Examples
Get all updates for agenda 15 in 2017
/api/3/agendas/2017/15/updates
Usage
Get a list of agenda digests in a specific time range of the calendar year to now
(GET) /api/3/agendas/{year}/{agendaNo}/updates/{from}
Note
Where ‘from’ is an ISO date time
Examples
Get updates for agenda 12 in 2017 from Feb 1st, 2017 to now
/api/3/agendas/2017/12/updates/2017-02-01
Usage
Return agenda digests that have changed during a specified date/time range
(GET) /api/3/agendas/{year}/{agendaNo}/updates/{from}/{to}
Note
Where ‘from’ and ‘to’ are ISO date times
Examples
Get updates for agenda 12 in 2017 from Jan 1st, 2017 to Dec 1st, 2017
/api/3/agendas/2017/12/updates/2017-01-01/2017-12-01?type=published