---
title: Get User ACL
framework: Apple Ads Platform API
role: symbol
role_heading: Web Service Endpoint
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/get-user-acls
---

# Get User ACL

Return the ad accounts and roles accessible to the authenticated API caller.

## URL

GET https://api.ads.apple.com/v1/acls

## Response Codes

200 OK: Successful operation. Returns UserAclListResponse (result: UserAccessResult). 400 Bad Request: Bad Request. Returns ErrorResponse. 401 Unauthorized: Unauthorized. 403 Forbidden: Forbidden. 404 Not Found: Resource not found. Returns ErrorResponse. 429 Too Many Requests: Rate Limit Exceeded. See Applying Rate Limits. 500 Internal Server Error: Internal Server Error. Returns ErrorResponse.

## Discussion

Discussion This endpoint retrieves a UserAclListResponse for the authenticated user. The response contains a result object with an acls array. Each UserAcl entry contains an adAccount object and a roles array listing the roles the user holds for that account. To discover which ad accounts an API token can access and what permission level applies, use this endpoint at the start of a session. Each access token binds to exactly one org. The orgId on every returned adAccount will be the same. Payload Examples

## See Also

- [Get Me Details](apple-ads-platform-api/get-current-user-details.md)
- [Get Org by ID](apple-ads-platform-api/get-orgs-_id_.md)