REST API

Bench API

376 endpoints. Full CRUD. Real-time webhooks. Build anything.

Quick Start

Make your first API call in 30 seconds.

Base URL

https://benchagi.com/api

Authentication

# Include your API key in every request
X-API-Key: ke_live_your_api_key_here

Example — List Deals

curl https://benchagi.com/api/agent/deals \
  -H "X-API-Key: ke_live_abc123..." \
  -H "Content-Type: application/json"

Response

{
  "deals": [
    {
      "id": "deal_abc123",
      "customerName": "Johnson Residence",
      "status": "demo_scheduled",
      "value": 24500,
      "createdAt": "2024-01-15T09:00:00Z"
    }
  ],
  "total": 142,
  "limit": 20,
  "offset": 0
}

Core Resources

Every resource supports full CRUD operations with filtering, pagination, and search.

Deals

42 endpoints

Full pipeline lifecycle — create, update, move stages, activity logs

Contacts

28 endpoints

Customer and lead management with custom fields and search

Teams

18 endpoints

Team management, assignments, and role-based access

Projects

35 endpoints

Production tracking from sale through installation

Estimates

31 endpoints

Line items, templates, pricing rules, and PDF generation

Invoices

24 endpoints

Billing, payment tracking, and QuickBooks sync

Webhooks

Outbound webhook support for deal events. Configurable per-instance. Get notified when deals change stage, new leads arrive, or appointments are scheduled.

POST your-endpoint.com/webhook

Authentication

API key authentication via the X-API-Key header. Each key is scoped to your instance — your data is fully isolated from other tenants.

X-API-Key: ke_live_...

Rate Limits

Per-route configurable rate limiting. Default: 60 requests per minute. Rate limit headers included in every response so your agent can self-throttle.

X-RateLimit-Remaining: 58

OpenAPI Specification

Full OpenAPI 3.0 spec covering all 376 endpoints. Import into Postman, generate client SDKs, or feed it directly to your AI agent.

Get Your API Key

Start building integrations with the Bench API today.