> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.hollr.ai/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.hollr.ai/_mcp/server.

# API Reference


## API Docs

- HollrAI API > Calls [Start a single call](https://docs.hollr.ai/api-reference/hollr-ai-api/calls/make-call.md)
- HollrAI API > Batches [Create a batch of calls](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/create-batch.md)
- HollrAI API > Batches [List batches for a campaign](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/list-batches.md)
- HollrAI API > Batches [Get a batch's details](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/get-batch.md)
- HollrAI API > Batches [Cancel and delete a batch](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/delete-batch.md)
- HollrAI API > Batches [Rename a batch or edit its schedule (metadata only)](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/update-batch.md)
- HollrAI API > Batches [Get a batch's live status](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/get-batch-status.md)
- HollrAI API > Batches [Pause a batch](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/pause-batch.md)
- HollrAI API > Batches [Resume a batch](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/resume-batch.md)
- HollrAI API > Batches [Reschedule a batch's contacts and/or timing](https://docs.hollr.ai/api-reference/hollr-ai-api/batches/reschedule-batch.md)
- HollrAI API > Conversations [List conversations for the authenticated user](https://docs.hollr.ai/api-reference/hollr-ai-api/conversations/get-conversations.md)
- HollrAI API > Conversations [List conversations for a specific campaign](https://docs.hollr.ai/api-reference/hollr-ai-api/conversations/get-campaign-conversations.md)
- HollrAI API > Conversations [Get a single conversation](https://docs.hollr.ai/api-reference/hollr-ai-api/conversations/get-conversation.md)
- HollrAI API > Conversations [Update a conversation](https://docs.hollr.ai/api-reference/hollr-ai-api/conversations/update-conversation.md)
- HollrAI API > Conversations [Delete a conversation](https://docs.hollr.ai/api-reference/hollr-ai-api/conversations/delete-conversation.md)
- HollrAI API > Conversations [Get a conversation by its call SID](https://docs.hollr.ai/api-reference/hollr-ai-api/conversations/get-conversation-by-call-sid.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.hollr.ai/api-reference/openapi.json)
- [OpenAPI YAML](https://docs.hollr.ai/api-reference/openapi.yaml)


> **Note:** This page contains both a page directory (above) and the landing page content (below). The page directory is generated for agent use and does not appear on the landing page.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.hollr.ai/api-reference/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.hollr.ai/_mcp/server.

# API reference

The HollrAI API gives your application programmatic control over AI calling.

HollrAI itself is a full platform for building and deploying AI call agents. Campaigns and agents are configured in the platform at [app.hollr.ai](https://app.hollr.ai). This API surface covers two things: triggering calls under an already-configured campaign, and reading the conversation records those calls produce.

## Base URL

```text
https://api.hollr.ai
```

## Authentication

API requests use the `hollr-api-key` header. See [authentication](/authentication) for details.

## What's covered

#### Calls

Trigger a single outbound call or a batch of calls

#### Conversations

Retrieve and manage records created from calls

## Start with the Calls API

Before using the API, create a campaign and its agent in [app.hollr.ai](https://app.hollr.ai).

Your application only needs to know the campaign ID and the phone number to call:

```text
Your application
      │
      ▼
POST /v1/call/make-call
      │
      ▼
HollrAI campaign + agent
      │
      ▼
AI phone conversation
      │
      ▼
Conversation record
```

Use the [quickstart](/quickstart) for the complete flow.

## API Explorer

The API reference includes an interactive API Explorer where you can test requests against your API. Keep your API key private and only use credentials in environments where it is safe to make real requests.

## Errors and rate limits

See [errors and rate limits](/errors-and-rate-limits) for the standard error shape, HTTP status codes, and documented request/concurrency limits.