Sign in

v1

latestOpenAPI 3.0.1License2026-08-06111027.5 KB
Collections

Retrieve new or updated packages for a collection within a date range

get/collections/{collection}/{lastModifiedStartDate}/{lastModifiedEndDate}

Path parameters

collection'BILLS' | 'BILLSTATUS' | 'BUDGET' | 'CCAL' | 'CDIR' | 'CDOC' | 'CFR' | 'CHRG' | 'CMR' | 'COMPS' | 'CPD' | 'CPRT' | 'CREC' | 'CRECB' | 'CRI' | 'CRPT' | 'CZIC' | 'ECFR' | 'ECONI' | 'ERIC' | 'ERP' | 'FR' | 'GAOREPORTS' | 'GOVMAN' | 'GOVPUB' | 'GPO' | 'HJOURNAL' | 'HMAN' | 'HOB' | 'LSA' | 'PAI' | 'PLAW' | 'PPP' | 'SERIALSET' | 'SJOURNAL' | 'SMAN' | 'STATUTE' | 'USCODE' | 'USCOURTS' | 'USREPORTS' required

The collectionCode that you want to retrieve (e.g. BILLS, CREC, FR, PLAW, USCOURTS)

lastModifiedStartDatestring required

This is the start date and time in ISO8601 format (yyyy-MM-dd'T'HH:mm:ss'Z') Example: 2018-01-28T20:18:10Z

lastModifiedEndDatestring required

This is the end date and time in ISO8601 format (yyyy-MM-dd'T'HH:mm:ss'Z') Example: 2018-01-28T20:18:10Z

Query parameters

offsetMarkstring

Indicates starting record for a given request. Use in conjunction with pageSize to paginate through the results. For the first request, use * - for subsequent requests, this information will be provided in the nextPage field of the current response.

offsetinteger

This is the starting record you wish to retrieve-- 0 is the first record. This parameter is being deprecated and will be removed in the future. Please begin transitioning to use offsetMark instead. For more information see the deprecation warning announcement and discussion on this <a href="https://github.com/usgpo/api/issues/187" target="blank"> GitHub issue (usgpo/api #187) <i class="bi bi-github"></i></a>

pageSizeinteger required

The number of records to return for a given request. Max value is 1000

docClassstring

Filter the results by overarching collection-specific categories. The values vary from collection to collection. For example, docClass in BILLS corresponds with Bill Type --e.g. s, hr, hres, sconres.

congressinteger

Filters results by Congress, where applicable. For example 113 or 114.

billVersion'as' | 'ash' | 'ath' | 'ats' | 'cdh' | 'cds' | 'cph' | 'cps' | 'eah' | 'eas' | 'eh' | 'enr' | 'eph' | 'es' | 'fah' | 'fph' | 'fps' | 'hdh' | 'hds' | 'ih' | 'iph' | 'ips' | 'is' | 'lth' | 'lts' | 'nat' | 'oph' | 'ops' | 'pap' | 'pav' | 'pch' | 'pcs' | 'pp' | 'pwah' | 'rah' | 'ras' | 'rch' | 'rcs' | 'rdh' | 'rds' | 're' | 'reah' | 'renr' | 'res' | 'rfh' | 'rfs' | 'rft' | 'rh' | 'rhuc' | 'rih' | 'ris' | 'rs' | 'rth' | 'rts' | 's_p' | 'sas' | 'sc' | 'mostrecent'

Filter the results by overarching collection-specific categories.

courtCodestring
courtTypestring
statestring
topicstring
isGLPboolean
natureSuitCodestring
natureSuitstring

Response

OK

countinteger
messagestring
nextPagestring
previousPagestring