Requesting Queue Listings

The Queue List request retrieves a list of PNRs on a specific queue number, for a specified Pseudo City Code (PCC).

Note: Queue functionality is available on Worldspan (1P) with GdsQueue v35.0 and greater.

Schema

Located in GDSQueue.xsd:

• GdsQueueListReq
• GdsQueueListRsp

Request

A request for a Queue List is made using GdsQueueListReq in GDSQueue. Set RetrieveAll to "true" in the request to retrieve all PNRs for a PCC on a specific queue.

Important! 

• It is recommended that RetrieveAll is set to "false" for quicker responses. A follow-on request can be sent to get all PNRs if MorePNRExist is "true" in the response. A follow-on request can be sent to get all PNRs if MorePNRExist is "true" in the response.
  Note: The RetrieveAll recommendation is not applicable for 1G.

• In 1G, when GdsQueueListReq is sent with @RetrieveAll="false”, the response contains the attribute @MorePNRExist. However, there is no @NextResultReference or any other attribute or element with a key or token to use in a follow-on request.

• NextResultReference is not supported for 1G.

The ProviderCode and TargetBranch must be included in the request. The PseudoCityCode can also be sent in the request, but is not required. When the Pseudo City Code (PCC) is not included, it is determined by Universal API.

• If only the ProviderCode and PseudoCityCode are included, an error is returned: TargetBranch is required.

• If the Target Branch does not find a valid PseudoCityCode for the request, an error message is returned: Default PCC not provisioned for Provider & TargetBranch, please provide PCC.

• If provisioning cannot be found for the provider request for a Target Branch, either directly or from the agent, an error message is returned: Access to provider not provisioned.

The QueueSelector/QueueNumber attribute is also required. The other attributes in QueueSelector are optional:

• Category
• DateRange
• Surname

Important! Category and Date Range must be configured for agencies and other travel providers in GDS Desktop.

Response

The Queue List response contains the PNRs for the specified Pseudo City Code (PCC) and queue number.

The result returns a list of PNR locators in the specified queue with the surname, first name, and travel date. For Galileo and Apollo, the date added to the queue is also returned.

If RetrieveAll is set to "false" in the request, only the first 100 PNRs in the queue are retrieved.

• The MorePNRExists indicator in the response notifies the customer when there are more PNRs on the queue. However, there is no @NextResultReference or any other attribute or element with a key or token to use in a follow-on request.

• NextResultReference is not supported for 1G.

Exceptions

In Worldspan (1P), the same PNR can appear in the response multiple times. Different names in the same PNR display in separate lines.

Queue list functionality was previously only on Galileo (1G) and Apollo (1V). In GdsQueue v35.0 and later, Worldspan (1P) support queue list functionality.

ACH does not support queues.

NextResultReference is not supported for 1G.