Initiate a Call

POST /masking/calls

Dials Party A first; on answer, bridges Party B. Both parties see the masked number as the caller ID. Returns immediately with a call_sid — poll the status endpoint for progress, or use webhooks.

Body parameters

Parameter	Type	Required	Description
`party_a`	string	Yes	10-digit Indian mobile number to dial first.
`party_b`	string	Yes	10-digit Indian mobile number to bridge after Party A answers.
`max_duration_sec`	integer	No	Maximum bridged-call duration in seconds (10–7200). The call is automatically ended once Party B has been connected for this long. Leave unset for no limit.

Request

curl -X POST https://voice-api.edesy.in/v1/masking/calls \
  -H "Authorization: Bearer vp_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "party_a": "9876543210",
    "party_b": "9123456789"
  }'

const response = await fetch("https://voice-api.edesy.in/v1/masking/calls", {
  method: "POST",
  headers: {
    "Authorization": "Bearer vp_YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    party_a: "9876543210",
    party_b: "9123456789",
  }),
});
const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://voice-api.edesy.in/v1/masking/calls",
    headers={
        "Authorization": "Bearer vp_YOUR_API_KEY",
        "Content-Type": "application/json",
    },
    json={"party_a": "9876543210", "party_b": "9123456789"},
)
print(response.json())

Responses

201 — Call initiated successfully

{
  "data": {
    "call_sid": "d28be7cd-9840-4b23-9627-199f1ef81fc6",
    "status": "initiated",
    "party_a": "9876543210",
    "party_b": "9123456789",
    "masked_number": "917969002802"
  }
}

402 — Wallet balance is too low to start the call

{
  "error": {
    "code": "insufficient_balance",
    "message": "Insufficient balance. Please add funds to continue making calls."
  }
}

400 — Party A and Party B are the same number

{
  "error": {
    "code": "invalid_numbers",
    "message": "Party A and Party B cannot be the same number."
  }
}

See all error codes.