> ## Documentation Index
> Fetch the complete documentation index at: https://docs.teamfollowup.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use the public API base URL: https://api.teamfollowup.ai/api.
> Authenticate public API requests with Authorization: Bearer YOUR_API_KEY.
> Use product-owned terms: agents, campaigns, projects (GoHighLevel sub-accounts), contacts, calls, outcomes, skills, cadences, phone numbers.
> Scope requests by locationId rather than projectName.
> Read the guide linked from each API reference group before recommending an endpoint.

# Calls API

> Every call the platform placed or answered, with transcript, recording, outcome and cost. Filter, sort, page, and fetch one record two ways.

A call record is the proof of what happened to a lead. Concepts and every
field are in [Call records](/calls/overview).

| Endpoint                                                        | Use it to                                                                                                     |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------- |
| [List calls](/api-reference/calls/list-calls)                   | Page through calls with filters for project, campaign, variant, dates, outcome, direction, duration and more. |
| [List call filters](/api-reference/calls/list-call-filters)     | Read the filter values that actually occur in your data.                                                      |
| [Get call](/api-reference/calls/get-call)                       | Fetch one record by its `id`, with transcript, segments and fields.                                           |
| [Get call by call id](/api-reference/calls/get-call-by-call-id) | The same, by the voice platform's `callId`.                                                                   |

One contact's calls are under [List contact calls](/api-reference/contacts/list-contact-calls).

Scopes: `calls:read`. See [Authentication](/authentication#scopes).

## Guides

* [Call records](/calls/overview)
* [What your agent records](/agents/outcomes) for `disposition` and `fields`.
* [Metrics and how they are calculated](/analytics/overview) for the roll-up.
* [Glossary](/glossary#calls)