QueryResources method

Last Updated : Jun 05, 2026 |

This method takes a snapshot of the current outbound usage across all MPPs in the Experience Portal system and returns:

  • Total number of outbound resources available, both used and unused

  • Total number of unused SIP outbound resources

  • Total number of unused H.323 outbound resources

    If zones are enabled, the returned resource information is the information for all MPPs with the zone specified in the request, or for the default zone if no zone was specified.

You can use this method to determine the approximate availability of outbound resources before you use the LaunchCCXML or LaunchVXML method to start a new outbound session.

Keep in mind, however, that system usage is extremely dynamic. The QueryResources method only returns a snapshot of the current usage. It does not look for upcoming outbound calls or try to determine whether another LaunchCCXML or LaunchVXML command has just started and is about to claim one or more outbound resources.

In addition, this method reports the total number of outbound resources available across all MPPs in the Experience Portal system, or all MPPs in the specified zone, if zones are enabled. Each application only has access to the available ports on the MPP to which it is assigned. If your site has multiple MPPs, that means any single application will probably not have access to the total number of resources returned by this method. For more information on using applications that launch multiple outgoing calls, see Best practices.

Important:

The return values are described Return values.

Data Returned

Name

Type

Description

totalRes_returned

Integer

Total number of outbound resources available, both used and unused.

unusedSIP_returned

Integer

Total number of unused SIP outbound resources.

unusedH323_returned

Integer

Total number of unused H.323 outbound resources.

Note:

If zones are enabled, the resource information returned is the information for the zone specified in the request. If no zone is specified, the resource information returned is the information for the default zone.