---
title: "Event List"
method: GET
path: "/events"
tags: ["events"]
---

# Event List

`GET /events`

## Query parameters

- `jurisdiction` string — Filter by jurisdiction name or ID.
- `deleted` boolean — Return events marked as deleted?
- `before` string — Limit results to those starting before a given datetime.
- `after` string — Limit results to those starting before a given datetime.
- `require_bills` boolean — Limit results to events with associated bills.
- `include` EventInclude[] — Additional includes for the Event response.
- `apikey` string
- `page` integer
- `per_page` integer

## Headers

- `x-api-key` string

## Response `200`

Successful Response

- EventList
  - `results` Event[], required
    - `id` string, required
    - `name` string, required
    - `jurisdiction` CompactJurisdiction, required
      - `id` string, required
      - `name` string, required
      - `classification` 'state' | 'municipality' | 'country', required — An enumeration.
    - `description` string, required
    - `classification` string, required
    - `start_date` string, required
    - `end_date` string, required
    - `all_day` boolean, required
    - `status` string, required
    - `upstream_id` string, required
    - `deleted` boolean, required
    - `location` EventLocation
      - `name` string, required
      - `url` string, required
    - `links` Link[]
      - `url` string, required
      - `note` string
    - `sources` Link[]
      - `url` string, required
      - `note` string
    - `media` EventMedia[]
      - `note` string, required
      - `date` string, required
      - `offset` integer
      - `classification` string, required
      - `links` Link[], required
        - `url` string, required
        - `note` string
    - `documents` EventDocument[]
      - `note` string, required
      - `date` string, required
      - `classification` string, required
      - `links` Link[], required
        - `url` string, required
        - `note` string
    - `participants` EventParticipant[]
      - `note` string, required
      - `name` string, required
      - `entity_type` string, required
      - `organization` Organization
        - `id` string, required
        - `name` string, required
        - `classification` string, required
      - `person` CompactPerson
        - `id` string, required
        - `name` string, required
        - `party` string, required
        - `current_role` CurrentRole
          - `title` string, required
          - `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government', required — An enumeration.
          - `district` union
            - string
            - integer
          - `division_id` string
    - `agenda` EventAgendaItem[]
      - `description` string, required
      - `classification` string[], required
      - `order` integer, required
      - `subjects` string[], required
      - `notes` string[], required
      - `extras` object, required
      - `related_entities` EventRelatedEntity[], required
        - `note` string, required
        - `name` string, required
        - `entity_type` string, required
        - `organization` Organization
          - `id` string, required
          - `name` string, required
          - `classification` string, required
        - `person` CompactPerson
          - `id` string, required
          - `name` string, required
          - `party` string, required
          - `current_role` CurrentRole
            - `title` string, required
            - `org_classification` 'legislature' | 'executive' | 'lower' | 'upper' | 'government', required — An enumeration.
            - `district` union
              - …
            - `division_id` string
        - `bill` CompactBill
          - `id` string, required
          - `session` string, required
          - `identifier` string, required
          - `title` string, required
          - `other_identifiers` BillIdentifier[]
            - `identifier` string, required
        - `vote` CompactVoteEvent
          - `id` string, required
          - `motion_text` string, required
      - `media` EventMedia[], required
        - `note` string, required
        - `date` string, required
        - `offset` integer
        - `classification` string, required
        - `links` Link[], required
          - `url` string, required
          - `note` string
  - `pagination` PaginationMeta, required
    - `per_page` integer, required
    - `page` integer, required
    - `max_page` integer, required
    - `total_items` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openstates/apis/open-states-api-v3.md) · [All operations](https://skmtc.dev/openstates/apis/open-states-api-v3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openstates/open-states-api-v3/revisions/6d7f86636f9d/schema)