Integrate AI Receptionist into your application. Create receptionists, manage conversations, capture leads, and send SMS — all programmatically.
1. Get your API key from the Dashboard → API Keys page.
2. Include it as a Bearer token in all requests:
curl -X POST https://aireceptionist.fit/api/v1/chat \
-H "Authorization: Bearer air_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"receptionistId": "your_receptionist_id",
"message": "Hello, I need to book an appointment"
}'https://aireceptionist.fit/api/v1All API requests require a valid API key passed as a Bearer token in the Authorization header.
Authorization: Bearer air_your_api_key_hereAPI keys are prefixed with air_. You can generate and manage keys from your dashboard. Keys are shown only once on creation — store them securely.
Create, configure, and manage AI receptionists programmatically
Send messages and receive intelligent AI responses
Automatically extract and retrieve lead information
Send text messages from provisioned phone numbers
Monitor API usage, limits, and overage in real-time
Generate, manage, and revoke API keys from your dashboard
The API uses standard HTTP status codes:
| Status | Meaning |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request — missing or invalid parameters |
| 401 | Unauthorized — invalid or missing API key |
| 403 | Forbidden — plan limit exceeded |
| 404 | Not Found — resource doesn\'t exist |
| 500 | Internal Server Error |
| 502 | AI service temporarily unavailable |
Make your AI receptionist services discoverable by any AI agent in the ecosystem. ARD is an open standard that lets agents find and use tools published by any organization.
Fetch your catalog
Call GET /api/v1/partner-catalog with your API key and branding params
Host on your domain
Serve the response at yourdomain.com/.well-known/ai-catalog.json
Get discovered
ARD registries will index your capabilities — AI agents worldwide can find and use your services
{
"specVersion": "1.0",
"host": "yourdomain.com",
"publisher": { "name": "Your Brand" },
"entries": [
{
"identifier": "urn:ai:your-brand:api:chat",
"displayName": "Your Brand — AI Chat",
"type": "application/vnd.ai.chat+json",
"url": "https://aireceptionist.fit/api/v1/chat",
"capabilities": ["multi-turn-conversation", "lead-capture"]
}
]
}