Sonar API

Programmatic access to your sales pipeline - leads, calls, agent runs, and webhooks. REST over HTTPS, JSON in / JSON out, scoped API keys.

Base URL

https://sonar-cyan-seven.vercel.app/api/v1

Quickstart

Generate an API key in Settings / API keys, then:

bash
curl -H "Authorization: Bearer sk_..." \
  https://sonar-cyan-seven.vercel.app/api/v1/leads

Conventions

Responses

Successful responses return { "data": ... }. Errors return { "error": "..." } with an appropriate HTTP status (400 invalid input, 401 missing/invalid auth, 403 wrong scope, 404 not found).

Idempotency

POST endpoints create new resources every call - there's no idempotency-key header yet. Re-running the same payload will create duplicate rows.

Rate limiting

Per-org rate limits apply: 10 agent runs/day on Free, unlimited on Pro. Every response includes RateLimit-Remaining and Retry-After headers when applicable.