API REFERENCE

Calls

Access your call history, transcripts, and recordings. This API allows you to track the performance of your campaigns, analyze AI interactions, and retrieve detailed logs of every conversation.

List all calls

GEThttp://localhost:3000/api/calls

Returns a paginated list of all calls. You can filter by campaignUuid, status, or date range.

Query Parameters

Parameter	Type	Description
campaignUuid	string	Filter calls by campaign.
status	string	Filter by status: completed, failed, busy, no-answer.
recordUuid	string	Filter by specific record.
page	number	Page number for pagination.
limit	number	Items per page.

Responses

JSON

{
  "calls": [
    {
      "uuid": "call_12345",
      "campaignUuid": "campaign_67890",
      "recordUuid": "record_12345",
      "direction": "outbound",
      "status": "completed",
      "duration": 145,
      "cost": 0.45,
      "transcript": [
        {
          "role": "assistant",
          "text": "Hello, this is Sarah from Call Camp. How are you today?"
        },
        {
          "role": "user",
          "text": "I'm good, thanks for calling."
        }
      ],
      "recordingUrl": "https://storage.callcamp.com/recordings/call_12345.mp3",
      "summary": "Customer expressed interest in the promotion and requested a callback next Tuesday.",
      "createdAt": "2026-04-20T15:00:00Z"
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 10
}

Get call details

GEThttp://localhost:3000/api/calls/{uuid}

Retrieves the full details of a specific call, including the transcript, recording URL (if available), and AI analysis summary.

Responses

JSON

{
  "uuid": "call_12345",
  "campaignUuid": "campaign_67890",
  "recordUuid": "record_12345",
  "direction": "outbound",
  "status": "completed",
  "duration": 145,
  "cost": 0.45,
  "transcript": [
    {
      "role": "assistant",
      "text": "Hello, this is Sarah from Call Camp. How are you today?"
    },
    {
      "role": "user",
      "text": "I'm good, thanks for calling."
    }
  ],
  "recordingUrl": "https://storage.callcamp.com/recordings/call_12345.mp3",
  "summary": "Customer expressed interest in the promotion and requested a callback next Tuesday.",
  "createdAt": "2026-04-20T15:00:00Z"
}