This article was created in collaboration with Max Kahan, Python Developer Advocate.

At Vonage, we aim to deliver the maximum value with our APIs with minimum complexity. As a result, we are deprecating the Real-Time Indicators fields from the Number Insight Advanced API. Real-Time Indicators attributes are:

• active_status: Whether the end user's phone number is assigned to an operator's network.

• handset_status: Whether the end user's handset is reachable.

Why Are These Attributes Being Deprecated?

The real-time data attributes are redundant as their functionality is already covered by the attributes valid_number and reachable, which are available by default in the Number Insight Advanced API response. Deprecating the real-time data attributes ensures customers receive the same insights without incurring additional costs or needing to process unnecessary data.

Deprecation Timeline

The deprecation process will follow this timeline:

• Starting October 1, 2025, the API response will no longer include these attributes.

• If these deprecated attributes are requested after October 1st, the API response will return the below JSON:
  

  "real_time_data": {
          "active_status": null,
          "handset_status": ""
      }

  Copy

Next Steps

Transitioning to the default attributes will require no additional changes in billing or endpoint configuration.

We recommend reviewing your current implementation of the Number Insight Advanced API and ensuring you are not relying on the soon-to-be-deprecated attributes. 

Questions or concerns?

If you have any questions about this change or need guidance on transitioning our support team is here to help. You can also reach out to us on the Vonage Community Slack.

Thank you for your understanding and for helping us make our APIs more efficient and user-friendly.