Call reports

The same numbers as the Calls tab of Reports. They come with the call totals and take the same window and the same reports access. A key user who can manage the team gets the whole team’s calls; anyone else gets only the calls they placed. For each call, use the call log.

#Calls by day

Calls placed and conversations for each day in the window, oldest first, counted in the key user’s time zone.

Parameters

daysinteger · queryDefault 30: The last N days.
from, toYYYY-MM-DD · query: Whole days instead of days.

Returns

data[]object[]: One row per day that had calls.
data[].datestring: The day, YYYY-MM-DD.
data[].dialsinteger: Calls placed that day.
data[].conversationsinteger: Of those, calls that became a conversation.

Errors

HTTP	Code	When
400	`invalid_field`	A date that isn’t `YYYY-MM-DD`, or `days` that isn’t a whole number; `field` names it.
403	`permission_denied`	The key’s user has no reports access.
503	`report_unavailable`	The report couldn’t be read. Nothing changed; retry.

curl "https://api.tryready.com/v1/reports/calls/daily?days=3" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/v1/reports/calls/daily?days=3', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/v1/reports/calls/daily?days=3",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

{
  "success": true,
  "data": [
    { "date": "2026-10-29", "dials": 41, "conversations": 6 },
    { "date": "2026-10-30", "dials": 52, "conversations": 9 },
    { "date": "2026-10-31", "dials": 18, "conversations": 2 }
  ]
}

#Calls by outcome

How many calls ended in each outcome. Every outcome is in the answer, with 0 when none, so the counts add up to dials.

Parameters

daysinteger · queryDefault 30: The last N days.
from, toYYYY-MM-DD · query: Whole days instead of days.

Returns

data.dialsinteger: Calls placed in the window.
data.countsobject: Calls per outcome. The keys are interested, callback, not_interested, voicemail, no_answer, wrong_number, dq, answered, screened, none and other. An outcome a rep logged wins over what the phone network reported. none is a call with neither, and other is an older outcome the app no longer offers.

Errors

HTTP	Code	When
400	`invalid_field`	A date that isn’t `YYYY-MM-DD`, or `days` that isn’t a whole number; `field` names it.
403	`permission_denied`	The key’s user has no reports access.
503	`report_unavailable`	The report couldn’t be read. Nothing changed; retry.

curl "https://api.tryready.com/v1/reports/calls/outcomes?days=7" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/v1/reports/calls/outcomes?days=7', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/v1/reports/calls/outcomes?days=7",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

{
  "success": true,
  "data": {
    "dials": 111,
    "counts": { "interested": 7, "callback": 3, "not_interested": 5, "voicemail": 22, "no_answer": 48, "wrong_number": 1, "dq": 0, "answered": 9, "screened": 4, "none": 12, "other": 0 }
  }
}

#Calls by rep

One row per rep who placed calls, busiest first. A key user who can’t manage the team sees only their own row.

Parameters

daysinteger · queryDefault 30: The last N days.
from, toYYYY-MM-DD · query: Whole days instead of days.

Returns

data[]object[]: One row per rep.
data[].rep_idinteger or null: The rep’s user id. null for calls no rep placed.
data[].namestring: The rep’s name, or their email when they have no name.
data[].dials, conversations, talk_seconds, interestedinteger: The same counts as the call totals, for this rep.
scopestring: team or rep (only the key user’s calls).

Errors

HTTP	Code	When
400	`invalid_field`	A date that isn’t `YYYY-MM-DD`, or `days` that isn’t a whole number; `field` names it.
403	`permission_denied`	The key’s user has no reports access.
503	`report_unavailable`	The report couldn’t be read. Nothing changed; retry.

curl "https://api.tryready.com/v1/reports/calls/by-rep?from=2026-10-01&to=2026-10-31" \
  -H "X-API-Key: $READY_API_KEY"

const res = await fetch('https://api.tryready.com/v1/reports/calls/by-rep?from=2026-10-01&to=2026-10-31', {
  headers: {
    'X-API-Key': process.env.READY_API_KEY,
  },
});
const json = await res.json().catch(() => ({}));
if (!res.ok || json.success === false) {
  throw new Error(`${res.status}${json.error_code || json.code ? ' ' + (json.error_code || json.code) : ''}: ${json.error || json.message || res.statusText}`);
}

import os, requests

r = requests.get(
    "https://api.tryready.com/v1/reports/calls/by-rep?from=2026-10-01&to=2026-10-31",
    headers={"X-API-Key": os.environ["READY_API_KEY"]},
    timeout=30,
)
data = r.json() if r.headers.get("content-type", "").startswith("application/json") else {}
if not r.ok or data.get("success") is False:
    raise RuntimeError(f'{r.status_code} {data.get("error_code") or data.get("code") or ""}: {data.get("error") or data.get("message") or r.reason}')

Returns:

{
  "success": true,
  "data": [
    { "rep_id": 4812, "name": "Dana Cole", "dials": 640, "conversations": 101, "talk_seconds": 25120, "interested": 19 },
    { "rep_id": 4830, "name": "Sam Ortiz", "dials": 512, "conversations": 83, "talk_seconds": 19870, "interested": 14 }
  ],
  "scope": "team"
}