Calls

Your calls, as they were scored. The data is yours on every plan: lengths, numbers, scores and reasons. Never words, because we never hold any.

List calls

GET/v1/callsany key

Newest first, up to 200 at a time. To page, send the last row's started_at as before and its call_id as before_id; the pair is needed because imported calls often share a start second.

Query parameters

numberstring: Only calls on this protected number.
callerstring: Only calls with this other party.
prefixstring: Only callers starting with this, e.g. +1512555. Ignored when caller is set.
direction"inbound" | "outbound"
sincestring: Calls started at or after this time.
beforestring: Calls started before this time. The paging cursor.
before_idstring: With before: the call_id of the last row seen, to break ties.
limitintegerdefault 50: At most 200.

Response

callsobject[]: One object per call; the fields are below.

A call

Field	Type	Meaning
`call_id`	string	Your id for the call.
`number`	string	Your protected number.
`caller`	string	The other party. On an outbound call, who was dialled.
`direction`	"inbound" \| "outbound"
`source`	string	Where it came from: api, twilio, vapi, retell:import…
`started_at / ended_at`	string \| null	ISO 8601. ended_at is null while the call is open.
`end_reason`	string \| null	As reported at the end, or expired when no end ever arrived.
`duration_s`	integer \| null
`score`	number \| null	The ring-time score, 0 to 1.
`action`	string \| null	allow, review or reject.
`reasons`	string[]	Ring-time reasons and any live_* flags.
`spam_score`	integer \| null	0 to 100, once the call has ended or turns have arrived.
`cost`	number \| null	USD.
`attestation`	string \| null	STIR/SHAKEN, when the carrier said.

RequestShell

BASE=https://api.murusai.com

curl "$BASE/v1/calls" \
  -H "Authorization: Bearer $MURUSAI_KEY" \
  --get \
  --data-urlencode "number=+14155550100" \
  --data-urlencode "since=2026-09-21T00:00:00Z" \
  --data-urlencode "limit=2"

RequestNode

const BASE = "https://api.murusai.com";
const KEY = process.env.MURUSAI_KEY;

const url = new URL("/v1/calls", BASE);
url.search = new URLSearchParams({
  "number": "+14155550100",
  "since": "2026-09-21T00:00:00Z",
  "limit": "2"
});
const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${KEY}`,
  },
});
const data = await res.json();

RequestPython

import os, requests

BASE = "https://api.murusai.com"
KEY = os.environ["MURUSAI_KEY"]

r = requests.get(
    f"{BASE}/v1/calls",
    params={
        "number": "+14155550100",
        "since": "2026-09-21T00:00:00Z",
        "limit": "2",
    },
    headers={"Authorization": f"Bearer {KEY}"},
)
data = r.json()

200OKResponseJSON

{
  "calls": [
    {
      "call_id": "CA7f3e2a91c04b",
      "number": "+14155550100",
      "caller": "+15125550142",
      "direction": "inbound",
      "source": "twilio",
      "started_at": "2026-09-21T02:14:07.000Z",
      "ended_at": "2026-09-21T02:16:52.000Z",
      "end_reason": "completed",
      "duration_s": 165,
      "score": 0.92,
      "action": "reject",
      "reasons": [
        "stem_rate",
        "seen_on_network",
        "live_recording_likely"
      ],
      "spam_score": 78,
      "cost": 0.41,
      "attestation": "A"
    },
    { … }
  ]
}

The same calls as a spreadsheet, streamed, so a long history never has to fit in memory. Takes the filters of the list, without paging; until closes the window. The ring-time score is written as a percentage so it reads beside the spam score.

Query parameters

numberstring
callerstring
direction"inbound" | "outbound"
sincestring: Inclusive.
untilstring: Exclusive.

The response carries Content-Disposition: attachment; filename="murusai-calls-2026-09-21.csv", so a browser saves it. RFC 4180: cells with commas or quotes are quoted, quotes doubled.

RequestShell

BASE=https://api.murusai.com

curl "$BASE/v1/calls.csv" \
  -H "Authorization: Bearer $MURUSAI_KEY" \
  --get \
  --data-urlencode "since=2026-09-01T00:00:00Z" \
  --data-urlencode "until=2026-10-01T00:00:00Z"

RequestNode

const BASE = "https://api.murusai.com";
const KEY = process.env.MURUSAI_KEY;

const url = new URL("/v1/calls.csv", BASE);
url.search = new URLSearchParams({
  "since": "2026-09-01T00:00:00Z",
  "until": "2026-10-01T00:00:00Z"
});
const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${KEY}`,
  },
});
const data = await res.json();

RequestPython

import os, requests

BASE = "https://api.murusai.com"
KEY = os.environ["MURUSAI_KEY"]

r = requests.get(
    f"{BASE}/v1/calls.csv",
    params={
        "since": "2026-09-01T00:00:00Z",
        "until": "2026-10-01T00:00:00Z",
    },
    headers={"Authorization": f"Bearer {KEY}"},
)
data = r.json()

200OKResponse · text/csv

started_at,ended_at,duration_s,your_number,other_number,direction,source,spam_score,ring_score,action,reasons,cost_usd,end_reason,attestation,call_id
2026-09-21T02:14:07.000Z,2026-09-21T02:16:52.000Z,165,+14155550100,+15125550142,inbound,twilio,78,92,reject,stem_rate seen_on_network,0.4100,completed,A,CA7f3e2a91c04b

One call, live

GET/v1/calls/{call_id}/liveany key

Everything known about one call: the record, the live monitor's counters and flags, and the turn timeline: each turn's role, when it started and ended, how long it ran, how much was said, and whether it was cut off. This is what the dashboard draws.

Path parameters

call_idstringrequired: Your id for the call, URL-encoded.

Response

callobject: The call, as in the list, plus cost_breakdown, attrs, caller_region, caller_zip, provider_call_id.
liveobject | null: Counters and flags: user_turns, agent_turns, interruptions, user_ms, agent_ms, user_chars, agent_chars, longest_user_ms, longest_user_chars, flags, score. null when no turns ever arrived.
turnsobject[]: In order. Each: role, idx, started_at, ended_at, duration_ms, chars, words, interrupted.

Errors

unknown_call404: No call with that id on your account.

RequestShell

BASE=https://api.murusai.com

curl "$BASE/v1/calls/CA7f3e2a91c04b/live" \
  -H "Authorization: Bearer $MURUSAI_KEY"

RequestNode

const BASE = "https://api.murusai.com";
const KEY = process.env.MURUSAI_KEY;

const url = new URL("/v1/calls/CA7f3e2a91c04b/live", BASE);
const res = await fetch(url, {
  headers: {
    Authorization: `Bearer ${KEY}`,
  },
});
const data = await res.json();

RequestPython

import os, requests

BASE = "https://api.murusai.com"
KEY = os.environ["MURUSAI_KEY"]

r = requests.get(
    f"{BASE}/v1/calls/CA7f3e2a91c04b/live",
    headers={"Authorization": f"Bearer {KEY}"},
)
data = r.json()

200OKResponseJSON

{
  "call": {
    "call_id": "CA7f3e2a91c04b",
    "number": "+14155550100",
    "caller": "+15125550142",
    "score": 0.95,
    "action": "reject",
    "spam_score": 78,
    // …
  },
  "live": {
    "user_turns": 3,
    "agent_turns": 2,
    "interruptions": 0,
    "user_ms": 61200,
    "agent_ms": 9400,
    "longest_user_chars": 612,
    "flags": ["recording_likely", "monologue"],
    "score": 0.95
  },
  "turns": [
    {
      "role": "agent",
      "idx": 0,
      "started_at": "2026-09-21T02:14:09.000Z",
      "ended_at": "2026-09-21T02:14:14.000Z",
      "duration_ms": 5000,
      "chars": 84,
      "words": 16,
      "interrupted": false
    },
    { … }
  ]
}

Nothing on this page holds a transcript, and there is no endpoint that does. What is stored about a turn is its length in time, its length in characters and words, and a short hash used only to notice the same thing said again. See what we never see.

Calls

List calls

Query parameters

Response

A call

Export as CSV

Query parameters

One call, live

Path parameters

Response

Errors