---
title: "List recent agenda hits"
method: GET
path: "/api/v1/public/agenda-hits"
tags: ["Agenda hits"]
---

# List recent agenda hits

`GET /api/v1/public/agenda-hits`

## Request

- Base URL: `https://aicdapi.com`
- URL: `https://aicdapi.com/api/v1/public/agenda-hits`
- Auth: none required

Returns up to three recent classified agenda hits. Normalized `*Slug`
parameters take precedence over their legacy aliases when both are sent.

## Query parameters

- `jurisdictionSlug` string
- `jurisdiction` string
- `topicSlug` string
- `topic` string
- `excludeTopicSlug` string
- `excludeTopic` string
- `limit` integer

## Response `200`

Recent agenda hits.

- AgendaHitListEnvelope
  - `data` PublicAgendaHit[], required
    - `jurisdictionSlug` string, required
    - `jurisdictionName` string, required
    - `bodyName` string, required
    - `topicSlug` string, required
    - `meetingAt` string, date-time, required
    - `meetingTimePrecision` 'date' | 'time' | 'unknown' | 'null', nullable: Optional precision. date has no supplied clock; time is a verified source clock; unknown is unverified. Absent or null preserves pre-contract legacy precision and does not certify a clock.
    - `title` string, required
    - `summary` string, required
    - `businessImpact` string, required
    - `evidenceQuote` string, required
    - `sourceUrl` string, uri, required
    - `confidence` integer, required
    - `affectedLocation` AffectedLocationValue, required
      - `status` 'stated' | 'not_stated', required
      - `locations` AffectedLocation[], required
        - `kind` 'exact_address' | 'parcel_or_case' | 'zip_code' | 'council_district' | 'corridor' | 'named_development' | 'neighborhood' | 'citywide', required
        - `sourceText` string, required
    - `proceduralContext` AgendaProceduralContext, required
      - `proceduralStage` 'proposed' | 'scheduled' | 'recommended' | 'continued' | 'approved' | 'denied' | 'adopted' | 'unknown', required
      - `actingBodyRole` 'recommending' | 'final_decision_maker' | 'unknown', required
      - `nextBodyName` string, nullable, required
      - `nextMeetingDate` string, date, nullable, required
      - `actionKind` 'public_comment' | 'registration' | 'meeting' | 'staff_contact' | 'unknown', required
      - `actionUrl` string, uri, nullable, required
  - `meta` ResponseMeta
    - `pagination` PaginationMeta
      - `limit` 10, required
      - `returned` integer, required
      - `nextCursor` string, nullable, required: Opaque cursor for the next page, or null when traversal is complete.

## Other responses

- `400`: A path or query parameter is invalid or unsupported.
- `429`: More than 120 requests were made by this client IP in 60 seconds.
- `500`: The request could not be completed because of an internal error.

---

[API](https://skmtc.dev/aicdapi/apis/aicd-api.md) · [All operations](https://skmtc.dev/aicdapi/apis/aicd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicdapi/apis/aicd-api/revisions/0f3752fae465?raw)
