---
title: "Gets a list of management events"
method: GET
path: "/management-events"
tags: ["ManagementEvents"]
---

# Gets a list of management events

`GET /management-events`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/management-events`
- Auth: `appAuth` (a scheme the document does not define)

Retrieves a paginated list of management events for a given AgencyRef and all permissible branches.

## Query parameters

- `createdFrom` string, date-time
- `createdTo` string, date-time
- `modifiedFrom` string, date-time
- `modifiedTo` string, date-time
- `nextToken` string
- `maxResults` integer
- `upcoming` boolean
- `status` string[]

## Headers

- `AgencyRef` string, required

## Response `200`

Success

- AltoPropertyManagementApiModelsResponsesPagedResults1AltoPropertyManagementApiModelsResponsesManagementEvent
  - `meta` AltoPropertyManagementApiModelsResponsesMeta
    - `nextToken` string, nullable
    - `totalItems` integer
  - `items` AltoPropertyManagementApiModelsResponsesManagementEvent[], nullable
    - `id` string, nullable
    - `propertyId` string, nullable
    - `tenancyId` string, nullable
    - `branchId` string, nullable
    - `eventType` AltoPropertyManagementApiModelsResponsesManagementEventType
      - `key` string, nullable
      - `label` string, nullable
    - `status` 'Unspecified' | 'Pending' | 'InProgress' | 'Complete' | 'Cancelled' | 'Expired'
    - `priority` 'Unspecified' | 'High' | 'Normal' | 'Low'
    - `critical` boolean
    - `dueDate` string, date-time, nullable
    - `completionDate` string, date-time, nullable
    - `reminderDays` integer
    - `recurring` boolean
    - `rescheduledForDate` string, date-time, nullable
    - `notes` string, nullable
    - `createdDate` string, date-time, nullable
    - `modifiedDate` string, date-time, nullable

## Other responses

- `400`: Bad request

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)