Amazon Simple Email Service
API Reference (API Version 2010-12-01)
« 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...

ListIdentities

Description

Returns a list containing all of the identities (email addresses and domains) for a specific AWS Account, regardless of verification status.

This action is throttled at one request per second.

Request Parameters

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

IdentityType

The type of the identities to list. Possible values are "EmailAddress" and "Domain". If this parameter is omitted, then all identities will be listed.

Type: String

Valid Values: EmailAddress | Domain

Required: No

MaxItems

The maximum number of identities per page. Possible values are 1-100 inclusive.

Type: Integer

Required: No

NextToken

The token to use for pagination.

Type: String

Required: No

Response Elements

The following elements are returned in a ListIdentitiesResult structure.

Identities

A list of identities.

Type: String list

NextToken

The token used for pagination.

Type: String

Examples

Sample Request

                
POST / HTTP/1.1
Date: Sat, 12 May 2012 05:18:45 GMT
Host: email.us-east-1.amazonaws.com
Content-Type: application/x-www-form-urlencoded
X-Amzn-Authorization: AWS3 AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE,
 Signature=OruiFNV26DCZicLDaQmULHGbjbU8MbC/c5aIo/MMIuM=,
 Algorithm=HmacSHA256, SignedHeaders=Date;Host
Content-Length: 115

AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&Action=ListIdentities
&Timestamp=2012-05-12T05%3A18%3A45.000Z&
Version=2010-12-01
          
            

Sample Response

                
<ListIdentitiesResponse xmlns="http://ses.amazonaws.com/doc/2010-12-01/">
  <ListIdentitiesResult>
    <Identities>
      <member>example.com</member>
      <member>user@example.com</member>
    </Identities>
  </ListIdentitiesResult>
  <ResponseMetadata>
    <RequestId>cacecf23-9bf1-11e1-9279-0100e8cf109a</RequestId>
  </ResponseMetadata>
</ListIdentitiesResponse>