Get a call

curl --request GET \
  --url https://app.famulor.io/api/v1/calls/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.famulor.io/api/v1/calls/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.io/api/v1/calls/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.famulor.io/api/v1/calls/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.famulor.io/api/v1/calls/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "c1b2c3d4-0000-4000-8000-000000000010",
    "assistant_id": "a1b2c3d4-0000-4000-8000-000000000001",
    "phone_number_id": "p1b2c3d4-0000-4000-8000-000000000020",
    "direction": "outbound",
    "from_number": "+4930123456",
    "to_number": "+4915123456789",
    "status": "completed",
    "started_at": "2026-07-01T10:00:00Z",
    "answered_at": "2026-07-01T10:00:05Z",
    "ended_at": "2026-07-01T10:03:25Z",
    "duration_sec": 200,
    "transcript": {
      "items": [
        {
          "type": "message",
          "role": "assistant",
          "content": [
            "Hi! How can I help you today?"
          ]
        },
        {
          "type": "message",
          "role": "user",
          "content": [
            "Please book Friday afternoon."
          ]
        },
        {
          "type": "function_call",
          "name": "book_appointment",
          "call_id": "tool-1",
          "arguments": "{\"day\":\"Friday\",\"period\":\"afternoon\"}",
          "created_at": 1782900005.25
        },
        {
          "type": "function_call_output",
          "name": "book_appointment",
          "call_id": "tool-1",
          "output": "{\"booked\":true}",
          "is_error": false,
          "created_at": 1782900006.5
        }
      ]
    },
    "summary": "Caller rescheduled their appointment to Friday.",
    "evaluation": null,
    "metadata": {},
    "created_at": "2026-07-01T10:00:00Z",
    "updated_at": "2026-07-01T10:03:30Z",
    "recording_url": "https://storage.example.com/recordings/signed-url",
    "events": [
      {
        "id": "e1",
        "call_id": "c1b2c3d4-0000-4000-8000-000000000010",
        "type": "state_changed",
        "payload": {
          "status": "in_progress"
        },
        "created_at": "2026-07-01T10:00:05Z"
      }
    ]
  }
}

GET

calls

{id}

Get a call

curl --request GET \
  --url https://app.famulor.io/api/v1/calls/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.famulor.io/api/v1/calls/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.famulor.io/api/v1/calls/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.famulor.io/api/v1/calls/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://app.famulor.io/api/v1/calls/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "id": "c1b2c3d4-0000-4000-8000-000000000010",
    "assistant_id": "a1b2c3d4-0000-4000-8000-000000000001",
    "phone_number_id": "p1b2c3d4-0000-4000-8000-000000000020",
    "direction": "outbound",
    "from_number": "+4930123456",
    "to_number": "+4915123456789",
    "status": "completed",
    "started_at": "2026-07-01T10:00:00Z",
    "answered_at": "2026-07-01T10:00:05Z",
    "ended_at": "2026-07-01T10:03:25Z",
    "duration_sec": 200,
    "transcript": {
      "items": [
        {
          "type": "message",
          "role": "assistant",
          "content": [
            "Hi! How can I help you today?"
          ]
        },
        {
          "type": "message",
          "role": "user",
          "content": [
            "Please book Friday afternoon."
          ]
        },
        {
          "type": "function_call",
          "name": "book_appointment",
          "call_id": "tool-1",
          "arguments": "{\"day\":\"Friday\",\"period\":\"afternoon\"}",
          "created_at": 1782900005.25
        },
        {
          "type": "function_call_output",
          "name": "book_appointment",
          "call_id": "tool-1",
          "output": "{\"booked\":true}",
          "is_error": false,
          "created_at": 1782900006.5
        }
      ]
    },
    "summary": "Caller rescheduled their appointment to Friday.",
    "evaluation": null,
    "metadata": {},
    "created_at": "2026-07-01T10:00:00Z",
    "updated_at": "2026-07-01T10:03:30Z",
    "recording_url": "https://storage.example.com/recordings/signed-url",
    "events": [
      {
        "id": "e1",
        "call_id": "c1b2c3d4-0000-4000-8000-000000000010",
        "type": "state_changed",
        "payload": {
          "status": "in_progress"
        },
        "created_at": "2026-07-01T10:00:05Z"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

API key (fam_..., created under Settings → API Keys) or an OAuth 2.0 access token (fam_at_...). REST operations also require API Access for the credential's workspace. Keys can be restricted to scopes such as assistants:read, calls:write, campaigns:write, automations:read, dashboards:read, dashboards:write, leads:write, segments:write, loop:read, loop:write, phone_numbers:write, sip_trunks:write, knowledge:write, voices:read, billing:read, settings:write, platform:read, platform:write; a *:write scope implies the matching *:read. Automation and dashboard endpoints also accept the legacy calls:* scope. Keys without scope restrictions have full access within the workspace's available capabilities.

Path Parameters

string<uuid>

required

Call ID.

Response

The call with events and recording URL.

data

object

required

Show child attributes

API Reference

Account

Billing

API Keys

Workspaces

Assistants

Versions

Simulations

Voices

Tools

Knowledge Bases

Calls

History

QA

Callbacks

Campaigns

Leads

Segments

Suppression

Phone Numbers

Caller IDs

SIP Trunks

Carrier Connections

Famulor Loop

Messaging

SMS

Widgets

Integrations

Bookings

Automations

Milian Missions

Dashboards

Catalog

Settings

Migrations

White Label

Get a call

Authorizations

Path Parameters

Response