# Adam Calling public API

> Send AI phone calls, poll for results, and read transcripts, extractions, and recordings over a REST API.

Base URL: https://api.adamcalling.com/v1 — authenticate with an org-scoped API key in the Authorization header (raw, Bearer, or Api-Key form).

The complete machine-readable endpoint reference is the OpenAPI 3 spec at https://docs.adamcalling.com/openapi.json — the same schema the per-endpoint pages under https://docs.adamcalling.com/api/ are generated from.

## Table of Contents

- [Overview](https://docs.adamcalling.com/docs/intro.md): Drive Adam Calling programmatically — send a phone call, poll until it completes, then read the transcript, summary, extraction, and recording.
- [Authentication](https://docs.adamcalling.com/docs/authentication.md): Mint an org-scoped API key and send it in the Authorization header.
- [Send your first call](https://docs.adamcalling.com/docs/first-call.md): POST /calls with a phone number and a freeform task describing what the agent should do.
- [Poll for results](https://docs.adamcalling.com/docs/polling-and-lifecycle.md): GET /calls/{call_id} returns the full call object — transcript, summary, extraction, and recording once the call completes.
- [Use a pathway](https://docs.adamcalling.com/docs/pathways.md): Send a stored, versioned conversation flow instead of a freeform task.
- [Stop calls & watch events](https://docs.adamcalling.com/docs/call-control.md): List active calls, stop one or all of them, and follow a call's append-only event trace.
- [Errors, rate limits & scopes](https://docs.adamcalling.com/docs/errors-throttling-scopes.md): The one error envelope every endpoint uses, per-key rate limits, and key scoping.