---
title: Get User ACL
framework: Apple Ads
role: symbol
role_heading: Web Service Endpoint
platforms: [search ads 5.0+]
path: apple_ads/get-user-acl
---

# Get User ACL

Fetches roles and organizations that the API has access to.

## URL

GET https://api.searchads.apple.com/api/v5/acls

## Response Codes

200 OK: If successful, the API returns a list of ACL objects in the response payload with an HTTP status code of 200 (OK). If unsuccessful, the HTTP status code indicates the error with details in the error message. 401 Unauthorized: An unauthenticated call fails to get the requested response. 403 Forbidden: Insufficient rights to the resource. 429 : The API calls exceed rate-limit thresholds. See the Rate Limits subsection of Calling the Apple Ads API. 500 Internal Server Error: The Apple Ads server is temporarily down or unreachable. The request may be valid, but you need to retry it later.

## Discussion

Discussion The API uses a user access control list (ACL) for policy-based authorization to determine access to resources. The Get User ACL call fetches roles in all organizations. Each role has access to all organizations or a subset of them. Get user ACL example Campaign Groups The API treats your orgId like a campaign group. If you need to manage Apple Ads for multiple clients, or if you need to restrict user access to a subset of your campaigns, you can create additional campaign groups within your account. Otherwise, you can create and manage all your campaigns under your default orgId and campaign group.

## See Also

### Access Control List

- [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)