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

• Quick Start — make your first masked call
• Call Lifecycle — the states a call moves through
• API Reference — full endpoint documentation