Продукт
Компания
Ресурсы
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.

Contents
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:

Base URLhttps://api.ormiar.com/v1

1. Get your API key

Log in to your dashboard → IntegrationsREST 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_TOKEN
Never 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