| title | topic | type | roles | sourceExamples | ||
|---|---|---|---|---|---|---|
Overview |
number lookup |
overview |
|
|
This is an API used to connect a number provider to our number lookup service.
This API is designed for third-party phone number information providers.
This includes phone book services, spam detection services, and any other services that offer insights about phone numbers.
When you integrate as a number information provider, you'll receive a lookup request that contains a phone number. Your task will be to classify them and provide a display name lookup.
The information you provide will assist wg2 in enhancing the call experience, such as setting the display name for incoming calls.
When a subscriber receives a call over VoLTE, we will check if there is any configured Number Lookup Providers for the subscriber.
During call setup a number lookup request will be sent to each of the enabled Number Lookup Providers, if any.
If we have received any display name from the providers, we will show it to the subscriber.
This will be visible in the call screen, as seen in the image below where the display name is "Potential Spam".
Note: If the phone has the number stored as a contact, the phone will typically use this.
If the provider returns a empty display name (no hit in the phonebook) or fails to respond within the deadline, the call will be displayed as usual.
Results will be cached for a period of time to avoid unnecessary requests and latency.