Register for a free API key at api.govinfo.gov and include it as the api_key query parameter on all requests
Query the collections endpoint to list recently published USCOURTS packages: GET https://api.govinfo.gov/collections/USCOURTS/START_DATE_ISO8601?pageSize=25&offsetMark=*&api_key=YOUR_KEY where START_DATE_ISO8601 is formatted as YYYY-MM-DDTHH:MM:SSZ
Each item in the packages array contains a packageId; use it to fetch package-level metadata: GET https://api.govinfo.gov/packages/PACKAGE_ID/summary?api_key=YOUR_KEY
To download the full opinion ZIP, construct: GET https://api.govinfo.gov/packages/PACKAGE_ID/zip?api_key=YOUR_KEY
For bulk incremental harvesting, advance the START_DATE on each run to the lastModified value of the previous batch's most recent item
Known gotchas
The USCOURTS collection contains opinions from selected appellate, district, and bankruptcy courts via a GPO/AOUSC collaboration; not all federal courts participate
The offsetMark parameter must be URL-encoded when used in subsequent paginated requests; use * for the first call
The API has rate limits; the DEMO_KEY provides limited access and will throttle quickly — register a named key for any production or bulk workload
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp