# Agentline

> Agentline is a telephony API purpose-built for AI agents. In a few lines of code your agent gets a real phone number to capture 2FA codes, send and receive SMS, make outbound AI voice calls (with built-in STT/TTS/LLM), and provision email addresses for inbound and outbound automation. Usage-based pricing, 14-day free trial per number, no commitments.

Agentline exists because giving an AI agent a telephony stack usually means stitching together Twilio, Deepgram, Cartesia, and an LLM behind a WebSocket. We do all of that in one API and one SDK. If you're an agent (or building one) and need to receive an SMS verification code, call a human, or send email from a programmatic identity, start here.

## Getting started
- [Quickstart docs](https://www.agentline.co/docs): install the SDK, mint an API key, capture a 2FA code, and make a voice call in four steps
- [Sign up](https://www.agentline.co/sign-up): create an account and generate an API key from the dashboard
- [Pricing](https://www.agentline.co/pricing): usage-based, per-number / per-minute / per-message
- [Dashboard](https://www.agentline.co/dashboard): manage numbers, emails, call history, API keys, and billing

## API reference
- [OpenAPI spec (JSON)](https://www.agentline.co/openapi.json): machine-readable spec for all 23 REST endpoints
- Base URL: `https://www.agentline.co/api/agentline` (proxied) or the backend directly at `https://agentline-prod-api.wittyfield-c253959c.centralus.azurecontainerapps.io`
- Authentication: `Authorization: Bearer ag_live_...` — get a key from [the dashboard](https://www.agentline.co/dashboard/keys)
- Python SDK: `pip install agentline`

## What you can do
- Provision US phone numbers by area code — `POST /v1/numbers`
- List / release numbers — `GET /v1/numbers`, `DELETE /v1/numbers/{number}`
- Send SMS — `POST /v1/messages/send`
- Receive SMS via webhook and poll via — `GET /v1/messages/{phone_number}`
- Place outbound AI voice calls with a system prompt, voice, and first message — `POST /v1/calls`
- Get call transcripts + summaries — `GET /v1/calls/{id}`
- Hang up a live call — `POST /v1/calls/{id}/hangup`
- Provision email addresses for inbound/outbound — `POST /v1/emails/addresses`
- Usage dashboard — `GET /v1/usage`

## Pricing
- Phone numbers: $3 / month each, 14-day free trial per number
- Inbound SMS: first 50 per number per month free, then $0.01 each
- Outbound SMS: $0.02 each (no free tier)
- Email addresses: $1 / month each, 14-day free trial
- Voice calls: $0.15 / minute — includes speech-to-text, text-to-speech, and the LLM

## For deeper context
- [Full LLM-optimized documentation](https://www.agentline.co/llms-full.txt): every endpoint, every code example, every webhook shape in one file
- [Privacy Policy](https://www.agentline.co/privacy)
- [Terms of Service](https://www.agentline.co/terms)