---
title: "Get a filtered list of events"
method: GET
path: "/calendar/events/list.{format}"
tags: ["Events"]
---

# Get a filtered list of events

`GET /calendar/events/list.{format}`

This service will only return actual events, it will not show non-sitting days or recess periods.
            NB - the total number of days that can be returned by any single call is 31.

## Path parameters

- `format` string, required

## Query parameters

- `queryParameters.house` string
- `queryParameters.eventTypeId` integer
- `queryParameters.startDate` string, date-time
- `queryParameters.endDate` string, date-time
- `queryParameters.date` string
- `queryParameters.locationId` integer
- `queryParameters.memberId` integer
- `queryParameters.tag` string
- `queryParameters.committeeId` integer
- `queryParameters.inquiryId` integer
- `queryParameters.categoryId` integer
- `queryParameters.eventId` integer
- `queryParameters.categoryCode` string
- `queryParameters.answeringBodyIds` integer[]
- `queryParameters.searchTerm` string
- `queryParameters.groupChildEventsWithParent` boolean

## Response `200`

OK

- EventPoco[]
  - `Id` integer
  - `StartDate` string, date-time
  - `EndDate` string, date-time
  - `CancelledDate` string, date-time
  - `StartTime` string
  - `EndTime` string
  - `Description` string
  - `Notes` string
  - `SortOrder` integer
  - `EventActivities` EventActivity[]
    - `Id` integer
    - `StartTime` string
    - `EndTime` string
    - `Attendees` string[]
  - `Type` string
  - `House` string
  - `LeadHouse` string
  - `Category` string
  - `Location` string
  - `LocationMetadata` string
  - `HasSpeakers` boolean
  - `Committee` CommitteePoco
    - `Id` integer
    - `Description` string
    - `Category` 'General' | 'Select' | 'Joint' | 'Other'
    - `IsLords` boolean
    - `IsCommons` boolean
    - `Inquiries` InquiryPoco[]
      - `Id` integer
      - `Description` string
      - `SortOrder` integer
    - `ShowOnWebsite` boolean
  - `Tags` TagPoco[]
    - `Description` string
  - `Members` MemberPoco[]
    - `Id` integer
    - `Name` string
    - `ListAs` string
    - `Party` string
    - `MemberFrom` string
    - `PartyColour` string
    - `PhotoUrl` string
    - `SortOrder` integer
  - `Metadata` MetadataPoco[]
    - `Url` string
    - `Description` string
  - `SummarisedDetails` string
  - `BillId` integer
  - `BillName` string
  - `BillPageLink` string

---

[API](https://skmtc.net/parliament/apis/whats-on-calendar-api.md) · [All operations](https://skmtc.net/parliament/apis/whats-on-calendar-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/parliament/whats-on-calendar-api/revisions/4683d8d4b27c/schema)