---
title: ResponseEnvelope
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/recommendationresponsebody
---

# ResponseEnvelope

The standard response envelope for all Recommendations and Suggestions API endpoints.

## Declaration

```data
object RecommendationResponseBody
```

## Properties

result: Usually an array of recommendation, suggestion, or history objects returned by the endpoint. A single object for the Target CPA suggestion query response. Read-only. pagination: Pagination metadata for the result set. See ResponsePagination. Read-only. error: Error information when the request fails. Absent on success. See ResponseError. Read-only.

## Discussion

Discussion The response envelope is the standard wrapper returned by all Recommendations and Suggestions endpoints. The result field contains the response payload. It’s usually an array, but for the Target CPA suggestion query response (RecommendationQueryTargetCpaSuggestionResponse) specifically, it’s a single object, since that endpoint always returns one suggestion rather than a list. The pagination field describes the current page position and is null for apply and dismiss responses. Example {   "result": [     {       "id": "rec-budget-001",       "recommendationType": "DAILYCAP",       "campaignId": 789012,       "state": "AVAILABLE"     }   ],   "pagination": {     "offset": 0,     "pageSize": 20,     "totalCount": 1   } }

## Topics

### Dictionaries

- [RecommendationResponseBody.Result](apple-ads-platform-api/recommendationresponsebody/result-data.dictionary.md)

## See Also

- [TargetCpaRecommendation](apple-ads-platform-api/targetcparecommendation.md)
- [TargetCpaRecommendationHistory](apple-ads-platform-api/targetcparecommendationhistory.md)
- [DailyCapRecommendation](apple-ads-platform-api/dailycaprecommendation.md)
- [DailyCapRecommendationHistory](apple-ads-platform-api/dailycaprecommendationhistory.md)
- [ApplyTargetCpaRecommendation](apple-ads-platform-api/applytargetcparecommendation.md)
- [ApplyDailyCapRecommendation](apple-ads-platform-api/applydailycaprecommendation.md)
- [ResponseError](apple-ads-platform-api/recommendationresponseerror.md)
- [ResponseErrorDetail](apple-ads-platform-api/recommendationresponseerrordetail.md)
- [ResponsePagination](apple-ads-platform-api/recommendationresponsepagination.md)
- [Money](apple-ads-platform-api/recommendationmoney.md)
- [RecommendationApplyDailyBudgetResponse](apple-ads-platform-api/recommendationapplydailybudgetresponse.md)
- [RecommendationApplyTargetCpaResponse](apple-ads-platform-api/recommendationapplytargetcparesponse.md)
- [RecommendationBidStrategy](apple-ads-platform-api/recommendationbidstrategy.md)
- [RecommendationDismissDailyBudgetResponse](apple-ads-platform-api/recommendationdismissdailybudgetresponse.md)
- [RecommendationDismissTargetCpaResponse](apple-ads-platform-api/recommendationdismisstargetcparesponse.md)