Retrieve Subscribers by Subscriber Key

Use the Retrieve method to view information about a specific subscriber. The data that’s returned can contain the status of the subscriber, along with other information that can help you better target your sends.

This sample SOAP request shows how to retrieve information about a subscriber by specifying their subscriber key.

1<s:Envelope
2  xmlns:s="http://www.w3.org/2003/05/soap-envelope"
3  xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
4  xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
5  <s:Header>
6    <a:Action s:mustUnderstand="1">Retrieve</a:Action>
7    <a:To s:mustUnderstand="1">https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
8    <fueloauth xmlns="http://exacttarget.com">YOUR_ACCESS_TOKEN</fueloauth>
9  </s:Header>
10  <s:Body
11    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
12    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
13    <RetrieveRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
14      <RetrieveRequest>
15        <ObjectType>Subscriber</ObjectType>
16        <Properties>ID</Properties>
17        <Properties>CreatedDate</Properties>
18        <Properties>Client.ID</Properties>
19        <Properties>EmailAddress</Properties>
20        <Properties>SubscriberKey</Properties>
21        <Properties>UnsubscribedDate</Properties>
22        <Properties>Status</Properties>
23        <Properties>EmailTypePreference</Properties>
24        <Filter xsi:type="SimpleFilterPart">
25          <Property>SubscriberKey</Property>
26          <SimpleOperator>equals</SimpleOperator>
27          <Value>12345</Value>
28        </Filter>
29      </RetrieveRequest>
30    </RetrieveRequestMsg>
31  </s:Body>
32</s:Envelope>

Retrieve Subscribers by Subscriber Key

See Also