The Place_call API from Nousdata Inc. — 1 operation(s) for place_call.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/kelam-sh:kelam-sh-place-call-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Kelam Phone Calls Place Call API
description: Real phone calls for AI agents in the most realistic human voices, at a fraction of what managed voice-AI platforms charge. Place an outbound call to accomplish a task and get the outcome + transcript back, or provision your own inbound/outbound voice agent under your wallet. From $0.05 + $0.15/min, billed to the second in USDC. No account, no telephony setup.
version: 1.0.0
x-guidance: 'The most realistic (human-indistinguishable) voices, at a fraction of what managed voice-AI platforms charge. Paid actions (USDC): - POST /api/place_call { "to": "<E.164>", "task": "<what to do on the call>", optional "agent_id","extract","greeting","language" } — places an outbound call, blocks until it ends, returns { call_id, status, answered_by, duration_seconds, summary, outcome, transcript, recording_url, price_usd }. Uses a shared caller agent unless you pass agent_id (one you created). METERED by talk time: $0.05 connect + $0.15/min, billed to the second, capped at $2.00/call; a call that never reaches anyone is free. - POST /api/create_agent { "name","instructions", optional "inbound","outbound","voice_id","allow_callers" } — provisions and deploys a voice agent under your wallet; returns { agent_id, phone_number, inbound }. $2.00, billed once deployed. Requires wallet auth (SIWX). IMPORTANT: an inbound agent answers a caller only after you BOTH fund it (top_up) AND allowlist that caller (allow_callers here, or allowlist_number later). Until both are done it silently rejects every call. Pass allow_callers at create time to allowlist upfront. - POST /api/top_up { "calls": N } — buy N prepaid inbound-call credits at $0.40 each; each answered inbound call spends one. Inbound agents need credits to answer. - POST /api/build { "message", optional "session_id" } — talk to the Kelam builder to design/edit an agent in plain English. Omit session_id to start (the reply carries one); $0.40 per message. Read replies free with build_view. Free actions (wallet-authenticated via SIWX): - POST /api/allowlist_number { "agent_id","caller" } — let a phone number reach your inbound agent. - GET /api/list_agents — your created agents. GET /api/call_status?call_id=... — a call you placed. - GET /api/balance — your remaining inbound-call credits. GET /api/build_view?session_id=... — a builder session transcript. GET /api/health is a free liveness check. Agents you create are isolated per wallet; an inbound agent answers a caller only when it is BOTH funded (top_up) AND that caller is allowlisted (allow_callers / allowlist_number).'
contact:
name: Kelam
url: https://kelam.sh
servers:
- url: https://call.kelam.sh
tags:
- name: Place_call
paths:
/api/place_call:
post:
operationId: place_call
summary: A great-value way for an agent to make a real phone call, in a voice callers…
tags:
- Place_call
x-payment-info:
price:
mode: fixed
currency: USD
amount: '2.00'
protocols:
- x402: {}
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
to:
type: string
pattern: ^\+[1-9]\d{7,14}$
task:
type: string
minLength: 1
maxLength: 30000
agent_id:
type: string
maxLength: 120
extract:
maxItems: 20
type: array
items:
type: object
properties:
name:
type: string
pattern: ^[a-z][a-z0-9_]*$
type:
type: string
enum:
- string
- number
- boolean
- enum
description:
type: string
minLength: 1
enum:
type: array
items:
type: string
required:
- name
- description
greeting:
type: string
maxLength: 2000
language:
type: string
maxLength: 16
required:
- to
- task
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
call_id:
type: string
status:
type: string
answered_by:
anyOf:
- type: string
- type: 'null'
duration_seconds:
anyOf:
- type: number
- type: 'null'
summary:
anyOf:
- type: string
- type: 'null'
outcome:
type: object
propertyNames:
type: string
additionalProperties: {}
transcript:
type: array
items:
type: object
properties:
role:
type: string
text:
type: string
speaker:
anyOf:
- type: string
- type: 'null'
required:
- role
- text
- speaker
additionalProperties: false
recording_url:
anyOf:
- type: string
- type: 'null'
price_usd:
type: string
required:
- call_id
- status
- answered_by
- duration_seconds
- summary
- outcome
- transcript
- recording_url
- price_usd
additionalProperties: false
'402':
description: Payment Required
components:
securitySchemes:
siwx:
type: apiKey
in: header
name: SIGN-IN-WITH-X