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

Use the Retrieve method to return a single object type. This method retrieves only the specified object properties for properties that have values. Apply filters to ensure that you get only relevant results.

## C# Syntax

```
System.String retrieve = Retrieve(RetrieveRequest, RequestID, Results)
```

## Parameters

| Name              | Data Type                             | Description                                                                                                                                                                                                                                                                                                                                                                   |
| ----------------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `RequestID`       | String                                | A unique identifier for the request. This parameter contains a string value containing an output variable of the key of the request. By default, this value is a GUID.                                                                                                                                                                                                        |
| `Results`         | APIObject[]&                      | A collection of one or more objects to retrieve. This array contains one APIObjects object for each object that meets the retrieve criteria. To use the APIObject, cast the object into the object type specified in the string value of the ObjectType property. Then you are able to access the properties of the strongly typed object defined by the Properties property. |
| `RetrieveRequest` | [RetrieveRequest](https://developer.salesforce.com/docs/marketing/marketing-cloud/guide/retrieverequest.md) | Specifies a request to retrieve data. A RetrieveRequest instance is required for this parameter.                                                                                                                                                                                                                                                                              |

## Output

OverallStatus - A string value containing the overall status of the request. Valid status values include:

- OK - All objects were successfully retrieved.
- Error - this status means that an error occurred during the retrieve option. The first step to resolve this error is to verify the value of the Properties property.
- MoreDataAvailable - this status means that more data is available for the RetrieveRequest. A RetrieveRequest returning more than 2500 records has this status.