When a number is called, the default behaviour of ADNOS is to extend the life of that number. The amount of time it is extended by depends on your account settings, but the value is usually 90 days. This behaviour improves the user experience; it is possible that a user will store the number dialed and recall it again at a later date without another overlay being requested. With a 90 day expiry time it is likely that the overlay will still be in place and the call can be honoured. If the same overlay is provided to many users this extension results in the number never expiring.
In some situations, however, you may not wish the life of the number to be extended. This is particularly true if you are inegrating with an external system, and you know that the destination number will not be available after a certain time, but could also be the case if you only expect users to dial a given number once. By passing the calledExtension parameter, it is possible to define to the minute how much the lifetime of an overlay should be extended by when it is called, this frees up the number for use elsewhere and reduces the total volume of numbers used.
Note, the extension is calculated at the start of the call and is set to the latest of the possible values. If calledExtension has been set to 7 days, but the number already has an expiry date 10 days in the future, the the expiry date will not change.
We do not want overlays to last longer when they are called. We need to provide the calledExtension parameter in addition to the rest of the request:
Note, If this parameter is useful for your implementation, you may also wish to use the expiry and enforceExpiry parameters.