Documentation & API
Everything you need to integrate
in 5 minutes
REST API reference and Webhooks for syncing the system with your infrastructure. Receive leads, manage your calendar and analytics in real time.
⌘K
01 · Quick Start
Your first API request
The REST API lets you fetch data programmatically. All requests are made over HTTPS to the base URL:
1. Get your API key
Log in to your dashboard → Integrations → REST API → copy your Public API Token.
2. Make a test request
bash
curl -X GET https://api.ormiar.com/v1/stats \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-H "Content-Type: application/json"02 · Authentication
API keys & security
We use Bearer tokens. Pass your key in the Authorization header of every request. API access is available on the Enterprise plan only.
http
Authorization: Bearer YOUR_API_TOKENNever store API keys in frontend code (React/Vue). Requests must only originate from your backend.
03 · Webhooks
Real-time notifications
Webhooks let you instantly receive a POST on your server the moment the AI qualifies a lead or books an appointment. Set the destination URL in your dashboard → Integrations → REST API & Webhooks.
Webhook delivery is available on the Enterprise plan. The destination URL must be HTTPS — we never send lead data over plain HTTP.
Supported events
- lead_qualified — the bot collected contact info and qualified the lead
- lead_booked — the lead was scheduled for an appointment
Example payload (lead_qualified)
json
{
"event": "lead_qualified",
"bot_id": "XXXXX",
"client_id": "XXXXX",
"lead_data": {
"name": "XXXXX XXXXX",
"phone": "+XXXXX",
"interest": "Book a consultation"
},
"timestamp": "2026-05-17T14:33:00Z"
}04 · API Reference
All platform methods
Complete list of endpoints for CRM, dashboard, and website integrations.
05 · Security
Data protection
- All connections are secured with TLS 1.3.
- Public API access is restricted by plan policies (Business / Enterprise).
- Rate limiting: 120 requests / min per key. If exceeded — 429 Too Many Requests.
06 · Error Codes
HTTP codes
HTTP
Code
Description
400
BAD_REQUEST
Malformed request or invalid bot_id
401
UNAUTHORIZED
Missing or malformed Bearer token
403
FORBIDDEN
REST API is not available on your current plan
404
NOT_FOUND
Lead or resource not found (or insufficient permissions)
429
RATE_LIMITED
Request rate limit exceeded
500
SERVER_ERROR
Internal server error