Thank you for filling out the form. One of our mobile experts will be in touch shortly to discuss your inquiry.
If you have any other questions please feel free to email us directly at email@example.com
Mitto’s Number Masking API lets you enable communication between two parties without revealing their phone numbers to one another. With this API you can:
We organize our documentation as follows:
This section provides general information about the Mitto Numer Masking API such as endpoints, methods, and response format.
To get started with Mitto, do the following:
1. Sign up for a Mitto account at https://www.mitto.ch/contact/ or write to firstname.lastname@example.org.
2. Submit the IPs you want to use for requests. They must be whitelisted on Mitto’s system.
3. Mitto will respond with your API key and confirmation that your IP addresses and callback URL are configured.
The Number Masking API has multiple endpoints.
You must create an application and assign phone numbers to it made available by your service provider. This creates a pool of mask numbers that can be drawn from whenever you need to mask someone’s phone number in your application.
You create an application by sending a POST request to:
To retrieve a list of your applications, you send a GET request to:
You can retrieve details about a specific application if you have the identification number for the application. Send a GET request to:
You can update details about an existing application. Send a PUT request to:
Delete any application you created by sending a DELETE request to:
You can see what phone numbers can be used for masking. Send a GET request to:
Retrieve a single, specific phone number for phone masking if it is available. Send a GET request to:
You can add a phone number to a mask number pool for an application. Send a POST request to:
Get a list of all the masked numbers for a particular application. Send a GET request to:
Retrieve a specific masked number. Send a GET request to:
Update a masked number. Send a PUT request to:
Remove a masked number from an application’s masked number pool. Send a DELETE request to:
A context is a single instance of two individuals communicating. It belongs to an application and maps two participants. Create a context by sending a POST request to:
To see what contexts you created under a particular application, send a GET request to:
Retrieve a specific context from an application. Send a GET request to:
Update an existing context with a PUT request to:
You can delete a context you created by sending a DELETE request to:
Add participants to a context with a POST request to:
You can retrieve a list of participants in a context. Send a GET request to:
Retrieve a single participant from a context. Send a GET request to:
Remove a participant from a context. Send a DELETE request to:
An interaction is a call detail record for a given context. Each interaction represents a single communication caller and called participant. Get a list of interactions with a GET request to:
You can retrieve an individual interaction. Send a GET request to:
The response and content varies slightly by endpoint. The general format is to return a status code, message, any pagination information, and then a data dictionary. Here’s an example without pagination:
For more details, refer to the Number Masking Use Cases section.
Mitto’s Number Masking API uses basic authentication for each request. Basic authentication is a simple authentication method that’s built into the HTTP protocol. You send HTTP requests with an Authorization header formatted like so:
Authorization: Basic base64(accountID:API key)
In the example, you would replace base64(accountID:API key) with a base64-encoded string where the string consisted of “accountID:API key”.
For examples of requests using basic authentication, refer to Number Masking Use Cases.