---
title: "Retrieve events for a given VM"
method: GET
path: "/vms/{name}/events"
tags: ["vms"]
---

# Retrieve events for a given VM

`GET /vms/{name}/events`

## Query parameters

- `limit` integer
- `order` 'asc' | 'desc'
- `cursor` string

## Response `200`

OK

- Events

## Other responses

- `404` — VM resource with the given name doesn't exist

## Changes

- **2026-01-22** `099f849c9765` — 3 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `order`
- **2023-10-09** `e0632c7e52ea` — 1 breaking
  - the response's body type/format changed from ``/`` to `object`/`` for status `200`
- **2023-03-13** `4314dfaf9018` — 1 info
  - endpoint added
- **2023-01-26** `4b9547159dde` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/openai/apis/orchard/changes/vms/:name/events/get.md)

---

[API](https://skmtc.dev/openai/apis/orchard.md) · [All operations](https://skmtc.dev/openai/apis/orchard/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openai/orchard/revisions/d599e69bf6be/schema)