---
schema_version: "1"
id: ce6ab902cd007dfa20299eeb9a4d9afdf58c06667edb9f7867418897d8c367f7
title: Extract
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/extract.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/extract.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: eec32a7307b890afc54f1d5bbb1c2ed30ca5fb5ca20077e11c4d78b90867831f
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# Extract

Use the `Extract` method to extract a package to a Marketing Cloud Engagement FTP site. Specify the File Transfer Location only when the intent is to deliver the file to a different FTP site. To reduce performance impacts, run data extracts outside of working hours.

## Parameters

This method has the parameters described in this table.

| Name        | Data Type                                            | Description                                                        |
| ----------- | ---------------------------------------------------- | ------------------------------------------------------------------ |
| `RequestID` | String                                               | A unique identifier for the request.                               |
| `Requests`  | Array of [ExtractRequest](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/extractrequest.md) objects | The requests specifying execution properties for a method.         |
| `Results`   | Array of [ExtractResult[]](extractresult.md) objects | The results of a method execution returned as an output parameter. |

## Usage

This sample SOAP envelope demonstrates how to use the Extract method to initiate a data extract.

```xml
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:a="http://schemas.xmlsoap.org/ws/2004/08/addressing">
  <s:Header>
    <a:Action s:mustUnderstand="1">Extract</a:Action>
    <a:MessageID>urn:uuid:137067bb-1ec4-43e7-ba83-a183bexample</a:MessageID>
    <ActivityId CorrelationId="001eee78-681b-4165-9364-9610316736bb"
    xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">
    e6c2db06-4440-4a6d-8e23-abc0c7ee0e64</ActivityId>
    <a:ReplyTo>
      <a:Address>
      http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous</a:Address>
    </a:ReplyTo>
    <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">
    <ExtractRequestMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
      <Requests>
        <ID>c7219016-a7f0-4c72-8657-1ec12example</ID>
        <Parameters>
          <Parameter>
            <Name>StartDate</Name>
            <Value>4/1/2026 1:00:00 AM</Value>
          </Parameter>
          <Parameter>
            <Name>EndDate</Name>
            <Value>5/31/2026 1:00:00 AM</Value>
          </Parameter>
          <Parameter>
            <Name>ExtractBounces</Name>
            <Value>true</Value>
          </Parameter>
          <Parameter>
            <Name>ExtractClicks</Name>
            <Value>true</Value>
          </Parameter>
          <Parameter>
            <Name>ExtractConvers</Name>
            <Value>true</Value>
          </Parameter>
        </Parameters>
      </Requests>
    </ExtractRequestMsg>
  </s:Body>
</s:Envelope>
```

The response provides the status and a unique ID for the request.

```xml
<soap:Body>
  <ExtractResponseMsg xmlns="http://exacttarget.com/wsdl/partnerAPI">
    <OverallStatus>OK</OverallStatus>
    <RequestID>03bc4f0a-5527-4b10-8743-f9456example</RequestID>
    <Results />
  </ExtractResponseMsg>
</soap:Body>
```