---
title: "Keyless Poll Events"
method: GET
path: "/v1/x402/events"
tags: ["x402 Keyless"]
---

# Keyless Poll Events

`GET /v1/x402/events`

## Request

- Base URL: `https://api.agentline.cloud`
- URL: `https://api.agentline.cloud/v1/x402/events`
- Auth: none declared

Poll your wallet's telephony events (agent access token; prepaid balance).

Consume-once mailbox like classic GET /v1/events. POST with an
optional JSON body works identically to GET. For live calls
prefer the websocket: `ws(s)://<host>/v1/events/ws?agent_id=<id>&lease_token=<token>`
(same socket the classic flow uses; authenticated by lease_token).

## Query parameters

- `phone_number` string, nullable: Filter to one owned number's agent
- `event_type` string, nullable: e.g. 'call.completed', 'call.utterance'
- `limit` integer
- `lease_token` string, nullable

## Headers

- `authorization` string, nullable

## Request body

- KeylessEventsBody: Optional POST body for polling events (GET works identically).
  - `phone_number` string, nullable
  - `event_type` string, nullable
  - `limit` integer, nullable
  - `lease_token` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `401`: Agent access token required
- `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)