Introduction

Overview of the Edesy click-to-call number masking API — base URL, how masked calls work, and what you need to get started.

Introduction

The Edesy Number Masking API gives you programmatic access to the click-to-call masking platform. You bridge two phone numbers on a call where both parties see a masked number as the caller ID — their real numbers are never exposed to each other.

Base URL

All API requests are made to:

https://voice-api.edesy.in/v1

Every request must be made over HTTPS and include an Authorization: Bearer <API_KEY> header. See Authentication.

The call model

A masked call always connects two parties:

  • Party A — dialed first. Typically the person who initiated the request (e.g. a buyer clicking "Call seller").
  • Party B — bridged in once Party A answers.

You send both numbers to the Initiate a Call endpoint. The response returns a call_sid immediately — the call then progresses asynchronously through a series of lifecycle states, which you track by polling the status endpoint or subscribing to webhooks.

What you need

  1. An account on the masking portal — sign up at masking.edesy.in.
  2. An API key — create one on the API Keys page. Keys start with vp_.
  3. A funded wallet — masked calls are billed at Rs 1.50/minute from a prepaid wallet. Top up on the portal.

Next