# RetrieveRequest

The RetrieveRequest object retrieves data from the system.

## Properties

| Name                        | Data Type                                                                                | Description                                                                                                                                                  |
| --------------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `ClientIDs`                 | Array of [ClientID](/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](/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](/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](/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](/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](/docs/marketing/marketing-cloud/guide/request.md) objects             | Not used.                                                                                                                                                    |

## Related Items

- [Retrieve a Subscriber](/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](/docs/marketing/marketing-cloud/guide/retrieve_sentevent_details_for_job.md "Retrieve_SentEvent_Details_for_Job")
- [Retrieve a Triggered Send Summary](/docs/marketing/marketing-cloud/guide/retrieving_a_triggered_send_summary.md "Retrieving_a_Triggered_Send_Summary")
- [Retrieve Additional Email Attributes](/docs/marketing/marketing-cloud/guide/retrieving_additional_email_attributes.md "Retrieving_Additional_Email_Attributes")
- [Retrieve All Lists a Subscriber is On](/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](/docs/marketing/marketing-cloud/guide/retrieving_all_lists_for_a_send.md "Retrieving_All_Lists_for_a_Send")
- [Retrieve All Subscribers on a List](/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](/docs/marketing/marketing-cloud/guide/retrieving_audience_of_send_definition.md "Retrieving_Audience_of_Send_Definition")
- [Retrieve Data from a Data Extension](/docs/marketing/marketing-cloud/guide/retrieving_data_from_a_data_extension.md "Retrieving_Data_from_a_Data_Extension")
- [Retrieve the Results of an Import](/docs/marketing/marketing-cloud/guide/retrieving_the_results_of_an_import.md "Retrieving_the_Results_of_an_Import")