gc_list_activity

List government activity

Chronological government activity — what has happened recently, or over a time range. Optionally scoped through a View (an agency, topic, organization, rulemaking document, bill, legislator, or committee found via gc_search) and narrowed to activity groups: rulemaking (documents posted, comment deadlines, organization comments), press, grants, legislative (bill actions, cosponsors, committee changes), lobbying, awards, fec. Scoped to a single record (a bill, a rulemaking) it returns that record's complete history; through broader Views it returns the tracked feed — every response's coverage field says which. Use gc_list_comments for deep comment filtering and the getters for current state.

Input

Parameter	Type	Description
scope	object	The View to look through (omit for government-wide activity). Types: document, agency, topic, organization, legislator, bill, committee. Find ids with gc_search.
groups	string[]	Kinds of activity (default: all the scope supports). Valid: rulemaking, press, grants, legislative, lobbying, awards, fec.
event_types	string[]	Advanced: exact event types within the chosen groups.
commenter_types	individual \| business \| trade_association \| union \| government \| advocacy \| academic \| other[]	Document scope only: filter comment activity (e.g. exclude "individual").
since	string	ISO-8601 lower bound.
until	string	ISO-8601 upper bound (exclusive).
include_facets	boolean	Also return counts by group/event type within the scope and range.
cursor	string	—
limit	integer	Items per page (default 15).
response_format	concise \| detailed	—

Annotations

{
  "readOnlyHint": true,
  "idempotentHint": true,
  "openWorldHint": false
}

Examples

Recent activity through a View

An agency scope with one activity group; coverage says whether the stream is the complete record or the tracked feed.

{
  "scope": {
    "type": "agency",
    "id": "EPA"
  },
  "groups": [
    "press"
  ]
}

{
  "items": [
    {
      "group": "press",
      "type": "press_release.published",
      "occurred_at": "2026-07-15T21:22:07.612Z",
      "subject": {
        "type": "press_release",
        "id": "PR-FRESH",
        "title": "EPA announces fresh thing"
      },
      "source": "agency-press",
      "links": {
        "governmentcontext": "https://governmentcontext.com/agencies/EPA/press-releases/fresh-thing"
      }
    },
    {
      "group": "press",
      "type": "press_release.published",
      "occurred_at": "2026-07-06T21:22:07.612Z",
      "subject": {
        "type": "press_release",
        "id": "PR-OLD",
        "title": "EPA announces old thing"
      },
      "source": "agency-press",
      "links": {
        "governmentcontext": "https://governmentcontext.com/agencies/EPA/press-releases/old-thing"
      }
    }
  ],
  "next_cursor": null,
  "coverage": [
    {
      "group": "press",
      "kind": "since"
    }
  ]
}