API Reference Overview

Overview of the Edesy number masking REST API — base URL, authentication, endpoints, and conventions.

API Reference

Programmatic access to the Edesy click-to-call masking platform.

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

All requests are made over HTTPS and authenticated with a Bearer token — see Authentication. All responses are JSON. Successful responses wrap the payload in a data object; errors wrap it in an error object (see Error Codes).

Endpoints

Method Path Description
POST /masking/calls Initiate a Call
GET /masking/calls/:call_sid Get Call Status
GET /masking/calls/:call_sid/recording Get Call Recording
GET /masking/call-logs List Call Logs
GET /masking/stats Get Usage Stats
GET /masking/billing Get Wallet Balance

Prefer events over polling? Subscribe to Webhooks to receive a signed POST on every call state transition.

Conventions

  • Numbers are 10-digit Indian mobile numbers (e.g. 9876543210).
  • Timestamps are RFC 3339 / ISO 8601 in UTC (e.g. 2026-05-11T08:30:00Z).
  • Money values are in INR.
  • Rate limit: 100 requests/minute per API key (429 rate_limited when exceeded).