GET /calls

List the calls of your account that were created in a date range. Results are paginated and sorted by creation date in descending order.

Required Parameters

Parameter	Type	Description
from	String	Start of the date range (ISO 8601, e.g. 2026-10-01 or 2026-10-01T08:00:00Z). A date without a time starts at midnight UTC.
to	String	End of the date range (ISO 8601, e.g. 2026-10-31 or 2026-10-31T18:00:00Z). A date without a time includes the whole day, until midnight UTC of the next day. A date with a time is included.

caution

Encode the + sign of a time zone offset as %2B in the URL (e.g. 2026-10-31T18:00:00%2B01:00), otherwise it is read as a space and the request fails. You can also send the dates in UTC with the Z suffix.

Optional Parameters

Parameter	Type	Description
page	Integer	The page of calls. If not specified it will default to page 1.

Example Request

cURL

curl -X GET "https://api.callbell.eu/v1/calls?from=2026-10-01&to=2026-10-31" \
    -H "Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM" \
    -H "Content-Type: application/json"

Node

import axios from 'axios';

const response = await axios.get('https://api.callbell.eu/v1/calls', {
  params: {
    'from': '2026-10-01',
    'to': '2026-10-31'
  },
  headers: {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json'
  }
});

Ruby

require 'net/http'

uri = URI('https://api.callbell.eu/v1/calls')
params = {
  :from => '2026-10-01',
  :to => '2026-10-31',
}
uri.query = URI.encode_www_form(params)

req = Net::HTTP::Get.new(uri)
req.content_type = 'application/json'
req['Authorization'] = 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM'

req_options = {
  use_ssl: uri.scheme == 'https'
}
res = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(req)
end

Go

package main

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

func main() {
    client := &http.Client{}
    req, err := http.NewRequest("GET", "https://api.callbell.eu/v1/calls?from=2026-10-01&to=2026-10-31", nil)
    if err != nil {
        log.Fatal(err)
    }
    req.Header.Set("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM")
    req.Header.Set("Content-Type", "application/json")
    resp, err := client.Do(req)
    if err != nil {
        log.Fatal(err)
    }
    defer resp.Body.Close()
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)
}

PHP

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.callbell.eu/v1/calls?from=2026-10-01&to=2026-10-31');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type: application/json',
]);

$response = curl_exec($ch);

curl_close($ch);

Python

import requests

headers = {
    'Authorization': 'Bearer test_gshuPaZoeEG6ovbc8M79w0QyM',
    'Content-Type': 'application/json',
}

params = {
    'from': '2026-10-01',
    'to': '2026-10-31',
}

response = requests.get('https://api.callbell.eu/v1/calls', params=params, headers=headers)

C#

using System.Net.Http;
using System.Net.Http.Headers;

HttpClient client = new HttpClient();

HttpRequestMessage request = new HttpRequestMessage(HttpMethod.Get, "https://api.callbell.eu/v1/calls?from=2026-10-01&to=2026-10-31");

request.Headers.Add("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM");

request.Content = new StringContent("");
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

HttpResponseMessage response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
string responseBody = await response.Content.ReadAsStringAsync();

Java

import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.util.Scanner;

class Main {

    public static void main(String[] args) throws IOException {
        URL url = new URL("https://api.callbell.eu/v1/calls?from=2026-10-01&to=2026-10-31");
        HttpURLConnection httpConn = (HttpURLConnection) url.openConnection();
        httpConn.setRequestMethod("GET");

        httpConn.setRequestProperty("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM");
        httpConn.setRequestProperty("Content-Type", "application/json");

        InputStream responseStream = httpConn.getResponseCode() / 100 == 2
                ? httpConn.getInputStream()
                : httpConn.getErrorStream();
        Scanner s = new Scanner(responseStream).useDelimiter("\\A");
        String response = s.hasNext() ? s.next() : "";
        System.out.println(response);
    }
}

Rust

extern crate reqwest;
use reqwest::header;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut headers = header::HeaderMap::new();
    headers.insert("Authorization", "Bearer test_gshuPaZoeEG6ovbc8M79w0QyM".parse().unwrap());
    headers.insert("Content-Type", "application/json".parse().unwrap());

    let client = reqwest::blocking::Client::builder()
        .redirect(reqwest::redirect::Policy::none())
        .build()
        .unwrap();
    let res = client.get("https://api.callbell.eu/v1/calls?from=2026-10-01&to=2026-10-31")
        .headers(headers)
        .send()?
        .text()?;
    println!("{}", res);

    Ok(())
}

Response

Parameter	Type	Description
calls	Call[]	A list of calls.
meta	Object	Pagination metadata.

Meta Object

Parameter	Type	Description
page	Integer	Current page number.
pages	Integer	Total number of pages.

Example Response

response.json

{
  "calls": [
    {
      "uuid": "9f2c41d7a6b84e0c8d3f5a1b2c3d4e5f",
      "callDirection": "inbound",
      "callStatus": "terminated",
      "recordingStatus": "available",
      "contact": "eb2b914a977e4ab896e7b886698b3eac",
      "callStartedAt": "2026-10-30T10:00:00Z",
      "acceptedAt": "2026-10-30T10:00:05Z",
      "rejectedAt": null,
      "callEndedAt": "2026-10-30T10:04:12Z",
      "mediaExpiresAt": "2026-11-29T10:05:01Z",
      "recordingUrl": "https://s3.amazonaws.com/...recording.ogg?X-Amz-Expires=600&X-Amz-Signature=...",
      "transcriptUrl": "https://s3.amazonaws.com/...transcript.json?X-Amz-Expires=600&X-Amz-Signature=...",
      "urlExpiresAt": "2026-10-30T12:10:00Z"
    },
    {
      "uuid": "4b7e9a1c3d5f4e2a8b6c0d9e1f2a3b4c",
      "callDirection": "outbound",
      "callStatus": "rejected",
      "recordingStatus": null,
      "contact": "efd7d996470e463b89f079be6cf578ed",
      "callStartedAt": "2026-10-29T15:20:00Z",
      "acceptedAt": null,
      "rejectedAt": "2026-10-29T15:20:09Z",
      "callEndedAt": "2026-10-29T15:20:09Z",
      "mediaExpiresAt": null,
      "recordingUrl": null,
      "transcriptUrl": null,
      "urlExpiresAt": null
    }
  ],
  "meta": {
    "page": 1,
    "pages": 3
  }
}

Errors

The request returns 400 Bad Request when from or to is missing or is not a valid ISO 8601 date.

response.json

{
  "error": "to must be an ISO 8601 date"
}