Number Masking API

  • Version: 1.0
  • Host:
  • Protocols: https
  • Accepts: application/json
  • Responds With: application/json

Welcome to our Number Masking documentation!


The Number masking service enables your users to connect in a phone call, while keeping their phone numbers private. By implementing Wavecell’s Number Masking service, you can track all conversation metadata in your system while maintaining your customers’ privacy.

The main advantages of number masking solutions are:

  • Customer privacy
  • In platform transactions
  • Cost efficiency

This solution is ideal for the ridesharing, delivery or ecommerce industries where you want to connect your users without revealing any personal data. Wavecell API allows you to configure a virtual or proxy number from your pool of numbers to receive call events, status call backs and respond with your preferred call flow function.


To start using this solution, first you need to contact Wavecell team to set up the account and to enable your virtual numbers. After this initial step, you need to create a Wavecell API key on Wavecell’s Customer User Portal. Also you will need to setup two callback URLs: handleUrl and statusUrl.


With Wavecell API, you can use the following methods to create and manage Virtual Numbers and the flow of a Call as required in your application:

Number Masking flow

On the diagram below a simple number masking call diagram is shown: