# Introduction

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

Source: https://edesy.in/docs/number-masking/getting-started

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](https://edesy.in/docs/number-masking/getting-started/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](https://edesy.in/docs/number-masking/api-reference/initiate-call) endpoint. The response returns a `call_sid` immediately — the call then progresses asynchronously through a series of [lifecycle states](https://edesy.in/docs/number-masking/getting-started/call-lifecycle), which you track by polling the status endpoint or subscribing to [webhooks](https://edesy.in/docs/number-masking/api-reference/webhooks).

## What you need

1. An account on the masking portal — sign up at [masking.edesy.in](https://masking.edesy.in).
2. An **API key** — create one on the [API Keys page](https://masking.edesy.in/dashboard/api-keys). 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](https://edesy.in/docs/number-masking/getting-started/quick-start) — make your first masked call
- [Call Lifecycle](https://edesy.in/docs/number-masking/getting-started/call-lifecycle) — the states a call moves through
- [API Reference](https://edesy.in/docs/number-masking/api-reference) — full endpoint documentation