Introduction to API

// Retrieves all calls created in the last 2 hours using the Calls API v4.
//
// How to run:
// 1. Save to a file, e.g. retreaver_example.js
// 2. Edit the file changing API_KEY and COMPANY_ID
// 3. Run with: node retreaver_example.js
//
// Requires Node.js 18+ (uses the built-in global fetch — no npm install needed).

// Configuration
const API_KEY = "your-api-key"; // <- change to your api key https://retreaver.com/user/edit/api_access
const COMPANY_ID = "123"; // <- Change to your company ID visible here https://retreaver.com/company

// 2 hours in the past. Use RFC 3339 (iso8601) as a format
// 2026-02-25T18:08:31Z
// Note that the api accepts other params like
// created_at_end, caller, client_cid, call_flow_events
// and that calls could be sorted in different ways. Consult the documentation.
const createdAtStart = new Date(Date.now() - 2 * 3600 * 1000).toISOString();

const perPage = 100;
// Sorting by created_at ascending keeps the result set stable while we
// paginate (new calls get appended to later pages rather than shifting
// the pages we've already fetched).
const params = new URLSearchParams({
  api_key: API_KEY,
  created_at_start: createdAtStart,
  company_id: COMPANY_ID,
  per_page: perPage,
  sort_by: "created_at",
  order: "asc",
});
const BASE_URL = `https://api.retreaver.com/api/v4/calls.json?${params}`;
console.log(BASE_URL);

async function fetchCalls(page) {
  const response = await fetch(`${BASE_URL}&page=${page}`);

  if (response.ok) {
    return response.json();
  } else {
    console.log(`Error: ${response.status} - ${response.statusText}`);
    return null;
  }
}

async function main() {
  const allCalls = [];
  let page = 1;

  console.log("Starting call retrieval...");

  // Paginate using the page param until an empty page is returned
  while (true) {
    const calls = await fetchCalls(page);

    if (!calls) break;

    if (calls.length === 0) {
      console.log(`Page ${page}: No more calls, stopping.`);
      break;
    }

    allCalls.push(...calls);

    console.log(
      `Page ${page}: Processed ${calls.length} calls (Total: ${allCalls.length})`,
    );

    page += 1;

    // Safety break if you want to test with just a few pages first
    // if (page > 5) break;
  }

  console.log(`\nFinished! Total calls processed: ${allCalls.length}`);

  console.log();
  console.log(
    `${"UUID".padEnd(36)}  ${"Caller".padEnd(14)}  ${"Status".padEnd(10)}  Date`,
  );
  console.log("-".repeat(90));
  for (const item of allCalls) {
    const call = item.call;
    console.log(
      `${(call.uuid ?? "").padEnd(36)}  ` +
        `${(call.caller ?? "").padEnd(14)}  ` +
        `${(call.status ?? "").padEnd(10)}  ` +
        `${call.created_at ?? ""}`,
    );
  }

  const now = new Date();
  const pad = (n) => String(n).padStart(2, "0");
  const timestamp =
    `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}_` +
    `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
  const outputFile = `calls_${timestamp}.json`;
  const { writeFileSync } = await import("node:fs");
  writeFileSync(outputFile, JSON.stringify(allCalls, null, 2));

  console.log(`\nDone -- Saved ${allCalls.length} calls to: ./${outputFile}`);
}

main();

# Retrieves all calls created in the last 2 hours using the Calls API v4.
#
# How to run:
# 1. Save to a file, e.g. retreaver_example.rb
# 2. Edit the file changing API_KEY and COMPANY_ID
# 3. Run with: ruby retreaver_example.rb
require 'net/http'
require 'uri'
require 'json'

# Configuration
API_KEY = "your-api-key" # <- Change to your api key https://retreaver.com/user/edit/api_access
COMPANY_ID = "123" # <- Change to your company ID visible here https://retreaver.com/company

# 2 hours in the past. Use RFC 3339 (iso8601) as a format
# 2026-02-25T18:08:31Z
# Note that the api accepts other params like
# created_at_end, caller, client_cid, call_flow_events
# and that calls could be sorted in different ways. Consult the documentation.
created_at_start = Time.at(Time.now.to_i - 2 * 3600).utc.iso8601

per_page = 100
# Sorting by created_at ascending keeps the result set stable while we
# paginate (new calls get appended to later pages rather than shifting
# the pages we've already fetched).
BASE_URL = "https://api.retreaver.com/api/v4/calls.json?api_key=#{API_KEY}&created_at_start=#{created_at_start}&company_id=#{COMPANY_ID}&per_page=#{per_page}&sort_by=created_at&order=asc"
puts BASE_URL

def fetch_calls(page)
  uri = URI.parse("#{BASE_URL}&page=#{page}")
  response = Net::HTTP.get_response(uri)

  if response.is_a?(Net::HTTPSuccess)
    JSON.parse(response.body)
  else
    puts "Error: #{response.code} - #{response.message}"
    nil
  end
end

all_calls = []
page = 1

puts "Starting call retrieval..."

# Paginate using the page param until an empty page is returned
loop do
  calls = fetch_calls(page)

  break unless calls

  if calls.empty?
    puts "Page #{page}: No more calls, stopping."
    break
  end

  all_calls.concat(calls)

  puts "Page #{page}: Processed #{calls.length} calls (Total: #{all_calls.length})"

  page += 1

  # Safety break if you want to test with just a few pages first
  # break if page > 5
end

puts "\nFinished! Total calls processed: #{all_calls.length}"

puts
puts "%-36s  %-14s  %-10s  %s" % ["UUID", "Caller", "Status", "Date"]
puts "-" * 90
all_calls.each do |item|
  call = item["call"]
  puts "%-36s  %-14s  %-10s  %s" % [
    call["uuid"],
    call["caller"],
    call["status"],
    call["created_at"]
  ]
end

timestamp = Time.now.strftime("%Y%m%d_%H%M%S")
output_file = "calls_#{timestamp}.json"
File.write(output_file, JSON.pretty_generate(all_calls))

puts "\nDone -- Saved #{all_calls.length} calls to: ./#{output_file}"

# Retrieves all calls created in the last 2 hours using the Calls API v4.
#
# How to run:
# 1. Save to a file, e.g. retreaver_example.py
# 2. Edit the file changing API_KEY and COMPANY_ID
# 3. Run with: python3 retreaver_example.py
#
# Requires Python 3.6+ (uses only the standard library — no pip install needed).

import json
from datetime import datetime, timedelta, timezone
from urllib.parse import urlencode
from urllib.request import urlopen
from urllib.error import HTTPError, URLError

# Configuration
API_KEY = "your-api-key"  # <- Change to your api key https://retreaver.com/user/edit/api_access
COMPANY_ID = "123"  # <- Change to your company ID visible here https://retreaver.com/company

# 2 hours in the past. Use RFC 3339 (iso8601) as a format
# 2026-02-25T18:08:31Z
# Note that the api accepts other params like
# created_at_end, caller, client_cid, call_flow_events
# and that calls could be sorted in different ways. Consult the documentation.
created_at_start = (
    (datetime.now(timezone.utc) - timedelta(hours=2))
    .strftime("%Y-%m-%dT%H:%M:%SZ")
)

per_page = 100
# Sorting by created_at ascending keeps the result set stable while we
# paginate (new calls get appended to later pages rather than shifting
# the pages we've already fetched).
params = urlencode({
    "api_key": API_KEY,
    "created_at_start": created_at_start,
    "company_id": COMPANY_ID,
    "per_page": per_page,
    "sort_by": "created_at",
    "order": "asc",
})
BASE_URL = f"https://api.retreaver.com/api/v4/calls.json?{params}"
print(BASE_URL)


def fetch_calls(page):
    try:
        with urlopen(f"{BASE_URL}&page={page}") as response:
            return json.load(response)
    except HTTPError as error:
        print(f"Error: {error.code} - {error.reason}")
        return None
    except URLError as error:
        print(f"Error: {error.reason}")
        return None


all_calls = []
page = 1

print("Starting call retrieval...")

# Paginate using the page param until an empty page is returned
while True:
    calls = fetch_calls(page)

    if calls is None:
        break

    if not calls:
        print(f"Page {page}: No more calls, stopping.")
        break

    all_calls.extend(calls)

    print(f"Page {page}: Processed {len(calls)} calls (Total: {len(all_calls)})")

    page += 1

    # Safety break if you want to test with just a few pages first
    # if page > 5: break

print(f"\nFinished! Total calls processed: {len(all_calls)}")

print()
print(f"{'UUID':<36}  {'Caller':<14}  {'Status':<10}  Date")
print("-" * 90)
for item in all_calls:
    call = item["call"]
    print(
        f"{call.get('uuid', ''):<36}  "
        f"{call.get('caller', ''):<14}  "
        f"{call.get('status', ''):<10}  "
        f"{call.get('created_at', '')}"
    )

timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
output_file = f"calls_{timestamp}.json"
with open(output_file, "w") as f:
    json.dump(all_calls, f, indent=2)

print(f"\nDone -- Saved {len(all_calls)} calls to: ./{output_file}")