Skip to main content
POST
/
v1
/
calls
Initiate Call
curl --request POST \
  --url https://api.example.com/v1/calls \
  --header 'Content-Type: application/json' \
  --data '
{
  "toNumber": "<string>"
}
'
{
  "callSid": "<string>",
  "status": "<string>",
  "message": "<string>",
  "toNumber": "<string>"
}
Initiates a call by first calling your registered phone number, then connecting you to the destination. The call is automatically recorded and transcribed.

​
Request Body

​
toNumber
string
required
The destination phone number to call. Can be formatted with or without country code.

​
Request

curl -X POST "https://app.transcord.app/api/v1/calls" \
  -H "Authorization: Bearer tr_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"toNumber": "+14155551234"}'

​
Response

​
callSid
string
Unique identifier for the call (Twilio Call SID)
​
status
string
Call status, will be initiated
​
message
string
Human-readable status message
​
toNumber
string
The formatted destination number
Response
{
  "callSid": "CA1234567890abcdef",
  "status": "initiated",
  "message": "Call initiated. You will receive a call shortly.",
  "toNumber": "+14155551234"
}

​
How It Works

  1. Transcord calls your registered phone number
  2. When you answer, you’re connected to the destination number
  3. The call is recorded in dual-channel format
  4. After hangup, the recording is transcribed
  5. You receive an email with the transcript

​
Requirements

  • You must have a phone number registered in your account
  • You must have available minutes (subscription or free tier)
  • The destination number must not be blocked

​
Errors

StatusDescription
400Missing toNumber or invalid/blocked number
401Invalid or missing API key
403No minutes remaining
404User not found