Enterprise only

API Reference

Full REST API for programmatic access. Available on Enterprise plan.

Authentication

All requests require a Bearer token. Get your API key from /dashboard/integrations.

# Example request
curl https://closerai.org/api/v1/leads \
-H "Authorization: Bearer YOUR_API_KEY"

Base URL

https://closerai.org

Leads

GET
/api/v1/leads

List all leads. Filters: temperature, status, limit, offset.

POST
/api/v1/leads

Create a lead manually. Body: name, email, phone, budget, location, propertyType, temperature.

GET
/api/v1/leads/{id}

Get one lead with conversations, tasks, notes, deals.

PATCH
/api/v1/leads/{id}

Update any lead field.

DELETE
/api/v1/leads/{id}

Delete a lead.

Deals

GET
/api/v1/deals

List deals. Filters: stage, limit, offset.

POST
/api/v1/deals

Create a deal. Body: title, stage, propertyValue, commission, leadId.

Conversations

GET
/api/v1/conversations

List AI chat conversations. ?include_messages=true to hydrate messages.

Stats

GET
/api/v1/stats

Unified dashboard stats: leads by temp, deals by stage, pipeline value, conversion rate.

Rate limits

100 requests per minute per API key. Exceeding returns 429 with Retry-After header.

Webhooks (outgoing)

Configure your webhook URL in Settings to receive instant notifications when events occur.

// Fires on: lead.created
{
  "event": "lead.created",
  "timestamp": "2026-04-18T12:00:00.000Z",
  "lead": {
    "id": "abc",
    "name": "Jane Smith",
    "email": "jane@example.com",
    "temperature": "hot"
  }
}
Questions? Email AbdelrahmanAbdelati20@gmail.com