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

The RetrieveRequest object retrieves data from the system.

## Properties

| Name                        | Data Type                                          | Description                                                                                                                                                  |
| --------------------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ClientIDs`                 | Array of [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md) objects           | Specifies accounts and sub-accounts, including Enterprise 2.0, On-Your-Behalf, and Lock & Publish accounts, from which to retrieve data.                 |
| `ContinueRequest`           | String                                             | Represents the RequestID that identifies a previous Retrieve requestto continue processing (returns the next available batch of data for that request).      |
| `Filter`                    | [FilterPart](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/filterpart.md)                        | Specifies filter to apply to retrieve.                                                                                                                       |
| `ObjectType`                | String                                             | Specifies whether the object is a List, Subscriber, Email, or other type of object.                                                                          |
| `Options`                   | [RetrieveOptions](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieveoptions.md)              | Options associated with a request. For a Configure call, options include CREATE or DELETE.                                                                   |
| `PartnerProperties`         | Array of [APIProperty](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/apiproperty.md) objects     | A collection of metadata supplied by the client and stored by the system. These properties are accessible only via API.                                      |
| `Properties`                | ArrayOfString                                      | Specifies an array of property definitions available for an object type. You can retrieve allowed properties using the Describe method.                      |
| `QueryAllAccounts`          | Boolean                                            | Queries all accounts, including parent and all children, regarding an event (ignores specified ClientIDs).                                                   |
| `RepeatLastResult`          | Boolean                                            | Used with RetrieveAllSinceLastBatch option to repeat returning a date-based request.                                                                         |
| `RespondTo`                 | Array of [AsyncResponse](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/asyncresponse.md) objects | Not used.                                                                                                                                                    |
| `RetrieveAllSinceLastBatch` | Boolean                                            | Retrieve all data since last retrieve context. Works with added and modified data. You must include the same properties and filters as the previous request. |
| `Retrieves`                 | Array of [Request](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/request.md) objects             | Not used.                                                                                                                                                    |

## Related Items

- [Retrieve a Subscriber](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieve_a_subscriber_via_the_web_service_api.md "Retrieve_a_Subscriber_Via_the_Web_Service_API")
- [Retrieve Sent Event Details](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieve_sentevent_details_for_job.md "Retrieve_SentEvent_Details_for_Job")
- [Retrieve a Triggered Send Summary](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_a_triggered_send_summary.md "Retrieving_a_Triggered_Send_Summary")
- [Retrieve Additional Email Attributes](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_additional_email_attributes.md "Retrieving_Additional_Email_Attributes")
- [Retrieve All Lists a Subscriber is On](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_all_lists_a_subscriber_is_on.md "Retrieving_All_Lists_a_Subscriber_is_On")
- [Retrieve All Lists for a Send](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_all_lists_for_a_send.md "Retrieving_All_Lists_for_a_Send")
- [Retrieve All Subscribers on a List](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_all_subscribers_on_a_list.md "Retrieving_All_Subscribers_on_a_List")
- [Retrieve the Audience of an Email Send Definition](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_audience_of_send_definition.md "Retrieving_Audience_of_Send_Definition")
- [Retrieve Data from a Data Extension](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_data_from_a_data_extension.md "Retrieving_Data_from_a_Data_Extension")
- [Retrieve the Results of an Import](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieving_the_results_of_an_import.md "Retrieving_the_Results_of_an_Import")