API Quickstart

curl https://api.bolna.ai/user/me \
  -H "Authorization: Bearer $BOLNA_API_KEY"

import os, urllib.request, json

key = os.environ["BOLNA_API_KEY"]
req = urllib.request.Request(
    "https://api.bolna.ai/user/me",
    headers={"Authorization": f"Bearer {key}"},
)
print(json.load(urllib.request.urlopen(req)))

const res = await fetch("https://api.bolna.ai/user/me", {
  headers: { Authorization: `Bearer ${process.env.BOLNA_API_KEY}` },
});
console.log(await res.json());

curl https://api.bolna.ai/call \
  -H "Authorization: Bearer $BOLNA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "'"$BOLNA_AGENT_ID"'",
    "recipient_phone_number": "+919876543210"
  }'

import os, urllib.request, json

body = json.dumps({
    "agent_id": os.environ["BOLNA_AGENT_ID"],
    "recipient_phone_number": "+919876543210",
}).encode()
req = urllib.request.Request(
    "https://api.bolna.ai/call",
    data=body,
    headers={"Authorization": f"Bearer {os.environ['BOLNA_API_KEY']}",
             "Content-Type": "application/json"},
)
print(json.load(urllib.request.urlopen(req)))

const res = await fetch("https://api.bolna.ai/call", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.BOLNA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    agent_id: process.env.BOLNA_AGENT_ID,
    recipient_phone_number: "+919876543210",
  }),
});
console.log(await res.json());

curl https://api.bolna.ai/executions/EXECUTION_ID \
  -H "Authorization: Bearer $BOLNA_API_KEY"

import os, time, urllib.request, json

key = os.environ["BOLNA_API_KEY"]
exec_id = "EXECUTION_ID"
final = {"completed","no-answer","busy","failed","canceled","stopped","error","balance-low"}

while True:
    req = urllib.request.Request(
        f"https://api.bolna.ai/executions/{exec_id}",
        headers={"Authorization": f"Bearer {key}"},
    )
    data = json.load(urllib.request.urlopen(req))
    print("status:", data["status"])
    if data["status"] in final:          # wait for 'completed', not 'call-disconnected'
        print(data.get("transcript"))
        break
    time.sleep(5)

const key = process.env.BOLNA_API_KEY;
const execId = "EXECUTION_ID";
const final = new Set(["completed","no-answer","busy","failed","canceled","stopped","error","balance-low"]);

while (true) {
  const res = await fetch(`https://api.bolna.ai/executions/${execId}`, {
    headers: { Authorization: `Bearer ${key}` },
  });
  const data = await res.json();
  console.log("status:", data.status);
  if (final.has(data.status)) { console.log(data.transcript); break; }  // not call-disconnected
  await new Promise(r => setTimeout(r, 5000));
}