---
title: Calling the Apple Ads API
framework: Apple Ads
role: collectionGroup
role_heading: API Collection
path: apple_ads/calling-the-apple-search-ads-api
---

# Calling the Apple Ads API

Pass your access token in the authorization header of HTTP requests.

## Overview

Overview Before you can call the API, you need to perform the implementation steps in Implementing OAuth for the Apple Ads API. To call the Apple Ads Campaign Management API, pass your access token as Bearer in the authorization header of HTTP requests. The Bearer value informs the API that the bearer of the token has authorization to access the API and perform specified actions. The following is an example call to the API: curl "https://api.searchads.apple.com/api/v5/campaigns" \ -H "Authorization: Bearer {access_token}" \ -H "X-AP-Context: orgId={orgId}"  |   |   |  To return the userId and parentOrgId of an API caller, use Get Me Details. Handle Errors  |  |   |  |   |  |  Rate Limits Rate limits exist in the Apple Ads Campaign Management API to avoid latency and other system problems from too many API calls within a limited time. For API users that are using automated retry logic in their environments, Apple’s solution is to require the retry logic to increase retry attempts exponentially by seconds. For example, if your default minimum wait time between retries is 2 seconds, the next retry wait time is 4 seconds, and so forth. Set a maximum exponential backoff time, such as 16 seconds. After reaching the maximum time, don’t increase the wait period between retries. If the request fails, wait 2 seconds and retry the request. If the request fails, wait 4 seconds and retry the request. If the request fails, wait 8 seconds and retry the request. If the request fails, wait 16 seconds and retry the request.

## Topics

### Access Control List

- [Get User ACL](apple_ads/get-user-acl.md)
- [UserAcl](apple_ads/useracl.md)
- [UserAclListResponse](apple_ads/useracllistresponse.md)
- [Get Me Details](apple_ads/get-me-details.md)
- [MeDetail](apple_ads/medetail.md)
- [MeDetailResponse](apple_ads/medetailresponse.md)

### Error Responses

- [ApiErrorResponse](apple_ads/apierrorresponse.md)
- [ErrorResponseBody](apple_ads/errorresponsebody.md)
- [ErrorResponseItem](apple_ads/errorresponseitem.md)
- [IntegerResponse](apple_ads/integerresponse.md)
- [VoidResponse](apple_ads/voidresponse.md)

## See Also

### Essentials

- [Implementing OAuth for the Apple Ads API](apple_ads/implementing-oauth-for-the-apple-search-ads-api.md)
- [Using Apple Ads API Functionality](apple_ads/using-apple-search-ads-api-functionality.md)