# Retrieve an Email
Marketing Cloud Engagement has a new model for storing, finding, managing, creating, sharing, and distributing all content-related objects. Access the objects created with the new Content Builder tools using the REST API. Your existing SOAP API integrations only function with the Classic tools.
This page contains information about retrieving an email message via the SOAP API.
## Why Retrieve an Email
You can retrieve an email message for use in an email send or to update the information contained within the email.
## How to Retrieve anEmail
Use the sample code below as a model to construct your own API code.
### Sample .NET Code
```java
//Retrieve Email named "Sample"
//Local variables
SoapClient client = new SoapClient();
APIObject[] Results;
String requestID;
String status;
// Instantiate the retrieve request
RetrieveRequest rr = new RetrieveRequest();
rr.ObjectType = "Email";//required
// Setting up a simple filter
SimpleFilterPart sf = new SimpleFilterPart();
sf.SimpleOperator = SimpleOperators.equals;
sf.Property = "Name";
sf.Value = new String[] { "Sample" };
//Add Filter
rr.Filter = sf;
rr.Properties = new string[] { "ID", "Name" };//required
status = client.Retrieve(rr, out requestID, out Results);
Email email = (Email)Results[0];
```
### Sample Java Code (Axis 1.4)
```java
public Email testGetEmailById() throws RemoteException {
Soap stub = init();
RetrieveRequest retrieveRequest = new RetrieveRequest();
retrieveRequest.setObjectType("Email");
String[] stringArray = {"ID", "Name"};
retrieveRequest.setProperties(stringArray);
SimpleFilterPart filter = new SimpleFilterPart();
filter.setProperty("Name");
filter.setSimpleOperator(SimpleOperators.equals);
java.util.List filterValues = new ArrayList();
filterValues.add(new String("Sample"));
filter.setValue((String[]) filterValues.toArray(new String[filterValues.size()]));
retrieveRequest.setFilter(filter);
RetrieveRequestMsg retrieveRequestMsg = new RetrieveRequestMsg(retrieveRequest);
RetrieveResponseMsg retrieveResponseMsg = stub.retrieve(retrieveRequestMsg);
System.out.println("[overall status message] " + retrieveResponseMsg.getOverallStatus());
Email email = (Email) retrieveResponseMsg.getResults(0);
return email;
}
```
### Sample Python Code
```python
import logging
from suds.client import Client
from suds.wsse import *
errors = 0
import logging as log
### we setup the service logging
LOG_FILENAME = '/Users/username/Documents/Logs/request-log.txt'
### we setup a debugging logging
log.basicConfig(filename=LOG_FILENAME,level=log.debug)
#https://fedorahosted.org/suds/wiki/Documentation (Suds documentation and ws-security details)
def PrintAsHTML(url):
try:
client = Client(url)
email = client.factory.create('Email')
print client
prop = ['ID','Name']
rr = client.factory.create('RetrieveRequest')
rr.Properties=prop
rr.ObjectType='Email'
sec = Security()
token= UsernameToken('username','password')
sec.tokens.append(token)
client.set_options(wsse=sec)
resp = client.service.Retrieve(rr)
out_str ='Response ::: '
print resp.OverallStatus
print out_str
#Prints Client.last_received---> SOAP response
print client.last_received()
sent= client.last_sent()
print 'Soap Request ::: '
log.debug('Done')
print sent
except Exception, e:
print e
try:
PrintAsHTML('https://YOUR_SUBDOMAIN.soap.marketingcloudapis.com/etframework.wsdl')
except Exception, e:
print e
```
### Sample SOAP Request
```
Email
ID
Name
Subject
Status
PartnerKey
CreatedDate
Folder
CategoryID
EmailType
ID
equals
3096663
```
### Sample SOAP Response
```xml
RetrieveResponse
urn:uuid:e6973425-e466-4c0c-909f-fb7ecff76cb5
urn:uuid:079cf30b-4337-47d0-bca3-52d45ddb15bd
http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous
2017-02-21T13:47:25Z
2017-02-21T13:52:25Z
OK
94531ae9-7448-4e2b-aff0-a37c881a56f7
2009-07-01T08:45:34.71
3096663
Example Test
my emails
578613
Example Subject
New
Normal
```
## Related Items
[REST API](/docs/marketing/marketing-cloud/guide/content-api.md)