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

# Peek Events

`GET /v1/events/peek`

## Request

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

Peek at pending telephony events without consuming them.

Returns a preview of queued events (call completions, transcripts)
without removing them from the mailbox. Useful for checking if
there are events to process before committing to retrieve them.

Returns {"pending_count", "events"}: pending_count counts every queued
event for the account (or agent_id); events lists event_id, agent_id,
event_type and created_at, without payloads. Call poll_events to get the
payloads.

## Query parameters

- `agent_id` string, nullable: Only events for this agent (agt_... from list_agents). Omit for every agent on the account.
- `limit` integer: Most events to list, oldest first. Does not change pending_count.

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