> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkarta.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Review agent logs

> Find calls for an agent and troubleshoot call outcomes.

## Find calls

Use an `agent_id` from [List agents](https://docs.getkarta.ai/api-reference/agents/list-agents.md). Filter by status and time range to narrow the results.

```bash theme={null}
curl --fail-with-body 'https://api.getkarta.ai/public/v1/agent/logs' \
  -H "Authorization: Bearer $KARTA_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "page": 1,
    "size": 20,
    "agent_id": "agentexample",
    "call_status": "ended",
    "call_direction": "inbound",
    "call_start_timestamp": "2026-10-01T00:00:00Z",
    "call_end_timestamp": "2026-10-06T23:59:59Z"
  }'
```

Replace the example agent ID and dates with your own. Call-time filters use session timestamps.

## Review results

Use `call_id` to identify the call. Review its status, direction, and available duration and billing fields.

Results are newest first. Increase `page` while `pagination.has_more` is `true`. Keep the same `size` and filters.

No matches or `size: 0` returns an empty `data` array with `pagination.has_more: false`.

## Fetch the next page

When `pagination.has_more` is `true`, increment `page` in the request body. For example, after page 1:

```json theme={null}
{
  "page": 2,
  "size": 20,
  "agent_id": "agentexample",
  "call_status": "ended",
  "call_direction": "inbound",
  "call_start_timestamp": "2026-10-01T00:00:00Z",
  "call_end_timestamp": "2026-10-06T23:59:59Z"
}
```

Stop when `pagination.has_more` is `false`.

For all supported filters and response fields, see [Get agent logs](https://docs.getkarta.ai/api-reference/agents/list-agent-logs.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.