The call log

After this page you can find any call your workspace has received, narrow the log to the calls that answer a question, and read the totals that sit above it. The same log is on the Calls page of the console and on GET /api/v1/calls, and both are served by one query, so they cannot disagree.

The log holds every call that reached one of your tracking numbers, and every call a publisher won at auction on one of your campaigns. That includes the calls that were not routed: a call that met a closed campaign, a full cap or an empty wallet is still a row, with the reason code it ended under. A log that leaves out the calls that went nowhere cannot answer the question people ask it most.

What a row holds

Outcomes

A carrier status says how a phone call ended. It does not say whether you sold it. outcome does, in one word, chosen most specific first:

Filters

Filters combine with AND. The same vocabulary drives the call log, its CSV export and every report, so a filter you build here can be pasted into a report unchanged.

The totals above the list

Every answer carries a stats block computed over the same filter as the rows, across every page and not only the one you hold. total is stats.count. So the tiles above the table are always about the table.

• count, connected, converted, unrouted — counts, by the definitions in the Metrics glossary.
• connectRate is connected ÷ calls and conversionRate is converted ÷ connected. Both are fractions to four places, and both are null — not 0 — when there is nothing to divide by.
• revenueCents, payoutCents, profitCents, usageCents — sums, in integer cents.
• avgTalkSeconds is over connected calls only. totalTalkSeconds is their sum.

Sorting and paging

• sort takes startedAt (the default), talkSeconds or billedCents. Anything else falls back to startedAt. dir is asc or desc, and desc is the default.
• page starts at 1. pageSize defaults to 25 and is capped at 200; a larger value is clamped, not refused.
• To pull a whole window, use the CSV export rather than paging. It streams up to 100,000 rows and does not shift under you while new calls arrive.

Worked example: yesterday's unrouted calls

Acme Health's campaign looked quiet yesterday. The question is whether calls did not arrive, or arrived and went nowhere. Ask the log for the unrouted calls of that day, with the window written as instants so that the day is Chicago's and not UTC's. This needs a key with the calls:read scope — see API keys.

curl -G "https://api.buy3.io/api/v1/calls" \
  -H "Authorization: Bearer $BUY3_API_KEY" \
  --data-urlencode "outcome=unrouted" \
  --data-urlencode "from=2026-09-19T05:00:00Z" \
  --data-urlencode "to=2026-09-20T05:00:00Z" \
  --data-urlencode "pageSize=50"

{
  "data": [
    {
      "id": "7c1d0e9a-4b2f-4a63-8d15-9e0f1a2b3c4d",
      "ref": "CA-482201",
      "startedAt": "2026-09-19T21:14:02.000Z",
      "status": "no_answer",
      "outcome": "unrouted",
      "callerNumber": "+14155550142",
      "dialedNumber": "+18885550100",
      "campaign": { "id": "6a2d1f0e-8b7c-4c55-a1d3-0e9f8a7b6c5d", "name": "Medicare — Inbound" },
      "publisher": { "id": "c4e1a2b3-9d8f-4f6e-b5a4-1c2d3e4f5a6b", "name": "Northwind Media" },
      "buyer": null,
      "target": null,
      "talkSeconds": 0,
      "ringSeconds": 0,
      "converted": false,
      "revenueCents": 0,
      "payoutCents": 0,
      "profitCents": 0,
      "usageCents": 0,
      "reasonCode": "campaign_closed",
      "reasonSentence": "The call arrived outside the campaign's hours of operation.",
      "hasRecording": false,
      "tags": {
        "dialed_number": "+18885550100",
        "publisher": "Northwind Media",
        "caller_area_code": "415",
        "caller_state": "CA"
      }
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 14,
  "totalPages": 1,
  "stats": {
    "count": 14, "connected": 0, "converted": 0, "unrouted": 14,
    "connectRate": 0, "conversionRate": null,
    "revenueCents": 0, "payoutCents": 0, "profitCents": 0, "usageCents": 0,
    "avgTalkSeconds": 0, "totalTalkSeconds": 0
  },
  "from": "2026-09-19T05:00:00.000Z",
  "to": "2026-09-20T05:00:00.000Z",
  "timezone": "America/Chicago"
}

Fourteen calls arrived and all fourteen ended campaign_closed. The traffic was fine; the campaign's hours were wrong. Note connectRate is 0 — calls arrived and none connected — while conversionRate is null, because nothing connected for it to be a rate of. To see which reasons cost the most over a longer period, group a report by reason instead: see Report builder.

Who can read the log

• Owners and admins of the workspace, in the console. A workspace whose plan has lapsed can still read its log; it cannot change anything.
• An API key with calls:read. A key acts as its workspace and sees only that workspace's tracking calls.
• A publisher never sees this log. Their portal lists their own calls, with your buyers, your revenue and your margin left out. See Publisher portal.

Next steps