---
title: "Get agent logs"
method: GET
path: "/agents/{agentName}/logs"
---

# Get agent logs

`GET /agents/{agentName}/logs`

Retrieves logs for the specified agent with optional filtering and pagination.

## Path parameters

- `agentName` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `deploymentId` string
- `sessionId` string
- `query` string
- `order` 'asc' | 'desc'
- `startTime` integer
- `endTime` integer

## Response `200`

Agent logs retrieved successfully

- object
  - `total` object
    - `value` integer — Total number of log entries matching the query
    - `relation` 'eq' | 'gte' — Relation type for the total count (eq = exact, gte = greater than or equal)
  - `logs` object[] — List of log entries
    - `log` string — Log message content
    - `timestamp` string, date-time — Timestamp when the log was generated
    - `deploymentId` string, nullable — ID of the deployment that generated the log

## Other responses

- `400` — Invalid query parameters
- `404` — Agent not found
- `500` — Internal server error

---

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