Amazon Simple Queue Service
API Reference (API Version 2012-11-05)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...



Returns the URL of an existing queue. This action provides a simple way to retrieve the URL of an Amazon SQS queue.

To access a queue that belongs to another AWS account, use the QueueOwnerAWSAccountId parameter to specify the account ID of the queue's owner. The queue's owner must grant you permission to access the queue. For more information about shared queue access, see AddPermission or go to Shared Queues in the Amazon SQS Developer Guide.

Request Parameters

For information about the common parameters that all actions use, see Common Parameters.


The name of the queue whose URL must be fetched. Maximum 80 characters; alphanumeric characters, hyphens (-), and underscores (_) are allowed.

Type: String

Required: Yes


The AWS account ID of the account that created the queue.

Type: String

Required: No

Response Elements

The following element is returned in a structure named GetQueueUrlResult.


The URL for the queue.

Type: String


For information about the errors that are common to all actions, see Common Errors.


The queue referred to does not exist.

HTTP Status Code: 400


The following example Query request gets the URL for the specified queue.

Sample Request



Sample Response