---
title: "List execution logs by prompt or project"
method: GET
path: "/api/v1/logs"
tags: ["Logs"]
---

# List execution logs by prompt or project

`GET /api/v1/logs`

## Request

- Base URL: `https://getorquesta.com`
- URL: `https://getorquesta.com/api/v1/logs`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Either `promptId` or `projectId` is required. When `promptId` is set the logs are ordered
ascending by `sequence`; when `projectId` is set they are ordered descending by `timestamp`.

## Query parameters

- `promptId` string, uuid
- `projectId` string, uuid
- `limit` integer
- `afterSequence` integer

## Response `200`

Log list.

- object
  - `logs` LogEntry[], required
    - `id` string, uuid, required
    - `promptId` string, uuid, required
    - `level` 'debug' | 'info' | 'warn' | 'error', required
    - `category` string, required: e.g. tool, system, chat, summary
    - `message` string, nullable: Truncated at 10K chars. Full content is in `details`.
    - `details` object, nullable: Structured payload (tool_result, command output, etc.)
    - `durationMs` integer, nullable
    - `sequence` integer: Monotonically increasing within a prompt
    - `timestamp` string, date-time, required

## Other responses

- `400`: Neither `promptId` nor `projectId` provided.
- `401`: Missing or invalid API key.
- `403`: Insufficient scope, revoked token, or project-scope mismatch.
- `404`: Resource not found (or invisible to your scope).

---

[API](https://skmtc.dev/getorquesta/apis/orquesta-public-api.md) · [All operations](https://skmtc.dev/getorquesta/apis/orquesta-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getorquesta/apis/orquesta-public-api/revisions/7d27e0ae8324?raw)