Calls

Base path: https://api.recepta.ai/api/v1/api/calls All endpoints require an API key in x-api-key, and the permission noted on each.

List calls

calls:read

required

Query param	Type	Notes
`page`	integer	Page number
`limit`	integer	Items per page

curl "https://api.recepta.ai/api/v1/api/calls?page=1&limit=20" \
  -H "x-api-key: $RECEPTA_API_KEY"

Search calls

calls:read

required

Query param	Type	Notes
`q`	string	Search query
`status`	string	Filter by call status

curl "https://api.recepta.ai/api/v1/api/calls/search?q=water+heater" \
  -H "x-api-key: $RECEPTA_API_KEY"

Call analytics

analytics:read

required

Query param	Type	Notes
`startDate`	date	`YYYY-MM-DD`
`endDate`	date	`YYYY-MM-DD`

curl "https://api.recepta.ai/api/v1/api/calls/analytics?startDate=2026-07-01&endDate=2026-07-31" \
  -H "x-api-key: $RECEPTA_API_KEY"

Get a call

calls:read

required

Returns 404 if the call doesn’t exist in your workspace.

curl https://api.recepta.ai/api/v1/api/calls/CALL_ID \
  -H "x-api-key: $RECEPTA_API_KEY"

Create a web call

calls:create

required

Starts a browser-based call rather than dialing a phone number.

string

Agent to handle the call. Falls back to your default agent if omitted.

object

Arbitrary data attached to the call record.

Returns 201 on success.

Trigger an outbound call

calls:create

required

Dials a phone number using one of your agents. POST /api/v1/api/calls/phone is the equivalent underlying endpoint.

string

required

Number to call, E.164 — e.g. +14155551234.

string

required

One of your own provisioned numbers to call from.

string

Agent to use. Falls back to your default agent if omitted.

object

Arbitrary data attached to the call record.

curl -X POST https://api.recepta.ai/api/v1/api/calls/outbound \
  -H "x-api-key: $RECEPTA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "toNumber": "+14155551234",
    "fromNumber": "+14155559876",
    "metadata": { "campaign": "q3-quotes" }
  }'

Returns 201 on success, or 429 if your plan’s call limit is exhausted.

Outbound calling is subject to calling-hour restrictions, do-not-call obligations, and consent requirements in the called party’s jurisdiction. See Recording & consent.

Get a transcript

calls:transcript

required

curl https://api.recepta.ai/api/v1/api/calls/CALL_ID/transcript \
  -H "x-api-key: $RECEPTA_API_KEY"

Get a recording

calls:recording

required

Returns the recording URL for the call.

calls:transcript and calls:recording are separate from calls:read. An integration can read call metadata without access to what was said.

Delete a call

calls:delete

required

Deletion is permanent and removes the transcript and recording with the call record.

Real-time instead of polling

Subscribe to call.started, call.ended, call.transcript_ready, and call.human_escalation rather than polling this endpoint. See Webhooks.

Overview

Endpoints

Automation

List calls

Search calls

Call analytics

Get a call

Create a web call

Trigger an outbound call

Get a transcript

Get a recording

Delete a call

Real-time instead of polling

​List calls

​Search calls

​Call analytics

​Get a call

​Create a web call

​Trigger an outbound call

​Get a transcript

​Get a recording

​Delete a call

​Real-time instead of polling

List calls

Search calls

Call analytics

Get a call

Create a web call

Trigger an outbound call

Get a transcript

Get a recording

Delete a call

Real-time instead of polling