---
title: "Get app events"
method: GET
path: "/v1/projects/{project_id}/events"
tags: ["Logs, Metrics & Events"]
---

# Get app events

`GET /v1/projects/{project_id}/events`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/projects/{project_id}/events`
- Auth: HTTP bearer

Returns up to 12 lifecycle events of the app's instances, such as started, stopped, restarted or out of memory. You can read events from the last 7 days. Team permission: any project permission.

## Path parameters

- `project_id` string, required

## Query parameters

- `teamID` string: 24-character hexadecimal ID.
- `start` integer
- `end` integer
- `direction` 'backward' | 'forward'
- `search` string

## Response `200`

Events. Each event can include additional fields not listed here.

- object
  - `data` object[]
    - `id` string: ID of the instance the event is about.
    - `action` string: What happened, for example `start`, `stop`, `restart` or `oom`.
    - `time` string: When it happened, in Unix seconds.
    - `release` string: ID of the release the instance belongs to.
    - `tag` string: The release's tag, for example `v3`.

## Other responses

- `204`: The app has no successful releases yet, so there are no events.
- `400`: The body or a parameter is invalid (`message` says which), or `teamID` isn't a valid ID.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this app (`no_permission`).
- `404`: The app doesn't exist.
- `503`: The data is temporarily unavailable. Try again later.

---

[API](https://skmtc.dev/liara-cloud/apis/paas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/paas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/paas/revisions/610162e8a623?raw)