--- schema_version: "1" id: 94004250c5af3f99de6bad34bb6b8801e84d54d8c324e6c18f4f20ae759c27ef title: RetrieveOptions collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/retrieveoptions.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieveoptions.html source_site: developer.salesforce.com content_type: documentation content_hash: b44b837fd8d8096213f193a35d21bf39e1221f5737d0ae2056ceb70b5077970a products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # RetrieveOptions Use the RetrieveOptions object in conjunction with a Retrieve call to set the working ClientID for the call. ## Properties | Name | Data Type | Description | | ----------------------- | ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `BatchSize` | Integer | Number of records to return in each batch as part of a Retrieve call. | | `CallsInConversation` | Integer | Represents the number of calls that must be received before the conversation support in the asynchronous API begins processing. | | `Client` | [ClientID](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/clientid.md) | Specifies the account ownership and context of an object. The ClientID must be a child account of the authenticating parent account. | | `ConversationID` | String | Unique ID of initial async API call. All requests that are processed as a single unit have the same ConversationID. | | `IncludeObjects` | Boolean | Indicates whether the APIObject is included in the response. If you are only interested in the Result object and want to reduce the size of the response message, set this property to **True**. | | `OnlyIncludeBase` | Boolean | Reduce object to base APIObject information.Includes basic reference data associating object and request. | | `Priority` | String | Defines the priority for a triggered send. Valid values include Low, Medium, and High. | | `QueuePriority` | [Priority](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/priority.md) | Defines the priority for asynchronous sends. Accepted values are `High`, `Medium`, and `Low`. The default value is `Medium`. | | `RequestExpirationTime` | String | The date and time when the asynchronous API request expires. Specify the value in ISO 8601 format with UTC time or with a timezone offset. When you specify both `RequestExpirationTime` and `ScheduledTime` in a request, the `RequestExpirationTime` must occur after the `ScheduledTime`. | | `RequestType` | [RequestType](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/requesttype.md) | The type of request. Possible values are `synchronous` and `asynchronous`. | | `SaveOptions` | Array of [SaveOption](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/saveoption.md) objects | Specifies how information is overwritten. | | `ScheduledTime` | String | The date and time at which the request must be processed. Specify the value in ISO 8601 format with UTC time or a timezone offset. The specified time can be up to 30 days in the future. | | `SendResponseTo` | Array [AsyncResponse](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/asyncresponse.md) objects | Defines how responses are returned and under what conditions. Optional. | | `SequenceCode` | Integer | Specifies the processing sequence of a multi-step conversation. This optional property requires the use of ConversationID. |