List Events
curl --request GET \
--url https://api.agentline.cloud/v1/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.agentline.cloud/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.agentline.cloud/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Events
List Events
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.
Your AI agent should call this endpoint periodically to receive notifications about completed calls and their transcripts.
Filters:
- agent_id: only events for a specific AI agent
- event_type: e.g. “call.completed”, “call.failed”
GET
/
v1
/
events
List Events
curl --request GET \
--url https://api.agentline.cloud/v1/events \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.agentline.cloud/v1/events"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.agentline.cloud/v1/events', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"input": "<unknown>",
"ctx": {}
}
]
}Authorizations
AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...
Query Parameters
Filter events by AI agent ID
Filter by event type (e.g. 'call.completed', 'call.failed')
Maximum number of events to return (1-200)
Required range:
1 <= x <= 200Response
Successful Response