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

# Get app logs

`GET /v2/projects/{project_id}/logs`

## Request

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

Returns up to 100 lines of the app's output, newest first by default. How far back you can read depends on your bundle plan's log retention. To page through logs, move `start` or `end` past the last line you received. 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'
- `appletId` string
- `releaseId` string
- `search` string
- `last_lines` boolean

## Response `200`

Log lines, grouped by instance and release.

- object
  - `data` object[]
    - `metaData` LogStreamMetaData
      - `appletId` string: The instance that wrote the lines.
      - `releaseId` string: The release the instance belongs to.
    - `values` array[]: `[timestamp, line]` pairs. The timestamp is in nanoseconds since the Unix epoch, as a string.
      - string[]

## Other responses

- `204`: The app has no releases yet, so there are no logs.
- `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.
- `409`: You sent both `appletId` and `releaseId`.
- `428`: `start` is further back than your bundle plan's log retention, or `end` isn't after `start`.
- `503`: The data is temporarily unavailable. Try again later.

## Changes

- **2026-11-02** `610162e8a623`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liara-cloud/apis/paas/changes/v2/projects/:project_id/logs/get.md)

---

[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)