---
title: "List Events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# List Events

`GET /v1/events`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/events`
- Auth: HTTP bearer

Poll for telephony events from your AI agents.

Returns pending events such as call completions, transcripts, and
failures. Events are consumed on retrieval (one-time read) — once
polled, they are automatically deleted from the mailbox, so process or
store them. Use peek_events to look without consuming.

Returns {"events": [...], "count"}: each event has event_id, agent_id,
event_type, payload and created_at, oldest first. An empty list means
nothing is pending. Agents with a webhook receive events there instead.

## Query parameters

- `agent_id` string, nullable: Only events for this agent (agt_... from list_agents). Omit for every agent on the account.
- `event_type` string, nullable: Only events of this exact type, e.g. 'call.completed', 'call.failed', 'call.received' or 'sms.received'.
- `limit` integer: Most events to claim in this call, oldest first. Events past the limit stay queued for the next poll.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents.md) · [All operations](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/agentline/apis/agentline-prepaid-phone-service-for-ai-agents/revisions/18c0bdbb4b30?raw)