Get phone number history across the organization

GET/calls/phone-history

Returns a map of phone numbers to the number of calls and associated campaigns across the entire organization. Useful for detecting contacts that have already been reached.

Request

curl -X GET "https://www.getrevox.com/api/calls/phone-history" \
  -H "Authorization: Bearer $REVOX_API_KEY"

const res = await fetch("https://www.getrevox.com/api/calls/phone-history", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
  },
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.get(
    "https://www.getrevox.com/api/calls/phone-history",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{
  "phone_history": {
    "+33612345678": {
      "count": 3,
      "campaigns": [
        {
          "id": "8e1f2a3b-4c5d-4e6f-9a0b-1c2d3e4f5a6b",
          "name": "Appointment reminder"
        }
      ],
      "last_called_at": "2026-11-05T09:00:00Z",
      "last_outcome": "interested",
      "reached_human": true,
      "do_not_contact": false,
      "hot": false
    }
  }
}

Request body

No body: send the request without one.

Response

200

phone_historyobject<string, object>
Call history of every number the organization has called, keyed by phone number in E.164 format. Only completed attempts of calls that were not deleted count.
Keys: Phone number, in E.164 format.