# AgentLine Voice Events Feed

> AgentLine Voice Events Feed is a paid API for AI agents from api.agentline.cloud, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Retrieves a paginated list of telephony events (calls, utterances, SMS) for AI agent phone numbers on the AgentLine platform

## Facts

- Endpoint: GET https://api.agentline.cloud/v1/x402/events
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentline-voice-events-feed-ffb88ac1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CfKYpFu1BhiIqMAZhZ_Ft

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agentline-voice-events-feed-ffb88ac1
```

Example prompt: Show me the last 20 call.completed events for my AI agent phone number +12025550198 so I can see what calls came through recently.

## When to prefer this

Use this endpoint when you need to poll or retrieve historical telephony events (calls, utterances, SMS) for an AI agent number on AgentLine, especially when integrating with OpenClaw or Hermes Agent workflows and you need structured event data without setting up a webhook listener.

## Known failure modes

- Invalid or expired lease_token returns authorization error
- Unknown event_type string returns empty or error result
- Phone number not owned by the authenticated account returns empty list
- Limit value out of range may return validation error
- Payment not made (x402) results in 402 Payment Required before events are returned

## How this service works

Get a real phone number for your AI agent in under 10 minutes. Works with OpenClaw, Hermes Agent, and any LLM. Outbound calls, SMS, and inbound voice — one API. No telecom experience needed.

## Output

A list of telephony event objects filtered by the specified parameters, each representing a discrete event such as a completed call or a spoken utterance, associated with an AI agent phone number provisioned on AgentLine.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer"
  },
  "event_type": {
   "type": "string",
   "description": "e.g. 'call.completed', 'call.utterance'"
  },
  "lease_token": {
   "type": "string"
  },
  "phone_number": {
   "type": "string",
   "description": "Filter to one owned number's agent"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "count": {
   "type": "integer"
  },
  "events": {
   "type": "array",
   "items": {
    "type": "object"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentline-voice-events-feed-ffb88ac1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentline.cloud](https://www.zero.xyz/host/api.agentline.cloud/llms.txt)