---
schema_version: "1"
id: ab094fae32d1202a930be756438bcba69458c57b5c5b3e3bf568eff858e45033
title: Retrieve Subscribers by Subscriber Key
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/retrieving_subscribers_by_subscriber_key.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_subscribers_by_subscriber_key.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 4bfaea799abed718e81201597543af4bcbba64e749b9646208fd0de3a9beaa93
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# 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.

```xml
<s:Envelope
  xmlns:s="http://www.w3.org/2003/05/soap-envelope"
  xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing"
  xmlns:u="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
  <s:Header>
    <a:Action s:mustUnderstand="1">Retrieve</a:Action>
    <a:To s:mustUnderstand="1">https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/Service.asmx</a:To>
    <fueloauth xmlns="http://exacttarget.com">YOUR_ACCESS_TOKEN</fueloauth>
  </s:Header>
  <s:Body
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema">
    <RetrieveRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
      <RetrieveRequest>
        <ObjectType>Subscriber</ObjectType>
        <Properties>ID</Properties>
        <Properties>CreatedDate</Properties>
        <Properties>Client.ID</Properties>
        <Properties>EmailAddress</Properties>
        <Properties>SubscriberKey</Properties>
        <Properties>UnsubscribedDate</Properties>
        <Properties>Status</Properties>
        <Properties>EmailTypePreference</Properties>
        <Filter xsi:type="SimpleFilterPart">
          <Property>SubscriberKey</Property>
          <SimpleOperator>equals</SimpleOperator>
          <Value>12345</Value>
        </Filter>
      </RetrieveRequest>
    </RetrieveRequestMsg>
  </s:Body>
</s:Envelope>
```

## See Also

- _Salesforce Help_: [Subscriber Key in Marketing Cloud Engagement](https://help.salesforce.com/s/articleView?id=mktg.mc_es_subscriber_key.htm)