API reference - Lawtte

The Lawtte REST API is a plain HTTPS + JSON way to do what the Lawtte connector does. Both run the same code, so every call follows the same rules: consent, calling hours, Do Not Call, and daily limits.


Base URL	`https://www.lawtte.ai/api/v1`
Auth	`Authorization: Bearer lawtte_sk_…` — a connector key
Format	JSON in, JSON out
Rate limit	120 requests per minute per key

Authenticate

Create a key in Settings → AI connectors → Connector keys. Its permission decides what it can do:

Permission	Endpoints
Read call history	Every `GET`, plus `POST /calls/check`
Read history and place calls	Everything, including `POST /calls`, creating, updating and archiving saved agents, and editing the Do Not Call list

curl https://www.lawtte.ai/api/v1/calls \
  -H "Authorization: Bearer $LAWTTE_KEY"

Keys are for servers. A call-enabled key dials real people — never put one in browser or mobile code.

Endpoints


`GET /calls`	Recent calls, inbound and outbound
`POST /calls`	Place an AI call
`POST /calls/check`	Would this call be placed? Dials nothing
`GET /calls/{id}`	One call’s outcome and summary
`GET /calls/{id}/transcript`	What was said
`GET /agents` · `POST /agents`	Saved outbound agents
`GET /agents/{id}` · `PATCH` · `DELETE`	One saved agent
`GET /dnc` · `POST /dnc`	The Do Not Call list
`DELETE /dnc/{phone}`	Unblock a number

Errors

Every error has the same shape:

{ "error": { "code": "rejected", "message": "Lawtte didn't place this call. Do Not Call rule: …" } }

Status	`code`	Meaning
`400`	`invalid_request`	A field is missing or invalid; the message names it.
`401`	`unauthorized`	No key, or a wrong, revoked or expired one.
`403`	`insufficient_scope`	The key doesn’t have the permission this endpoint needs.
`404`	`not_found`	No such call, agent, number or endpoint for this account.
`422`	`rejected`	Lawtte refused — a call rule, a limit, or calling isn’t set up — and says why. Nothing was dialed or changed.
`429`	`rate_limited`	Over 120 requests a minute. Wait for the `Retry-After` seconds.
`500` / `503`	`internal_error` / `unavailable`	A problem on Lawtte’s side. Nothing was changed; retry with backoff.

Call limits and calling hours are on errors and limits.

Getting results back

Poll GET /calls/{id} after placing a call, or have Lawtte push each call to you with a signed webhook.

​Authenticate

​Endpoints

​Errors

​Getting results back

Authenticate

Endpoints

Errors

Getting results back