Contents

Get Advertiser Resources

Retrieve the advertiser resources available to your organization, filtered by resource type.

URL

GET https://api.ads.apple.com/v1/advertiser-resources

Query Parameters

NameTypeDescription
resourceType RequiredAdvertiserResourceType

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
AdvertiserResourceListResponse

Successful operation. Returns AdvertiserResourceListResponse (result: array of Delegation).

400Bad Request
Content-Type: application/json
Error

Bad Request. Returns ErrorResponse.

401Unauthorized
Content-Type: application/json
Error

Unauthorized.

403Forbidden
Content-Type: application/json
Error

Forbidden.

404Not Found
Content-Type: application/json
Error

Resource not found. Returns ErrorResponse.

429Too Many Requests
Content-Type: application/json
Error

Rate Limit Exceeded. See Applying Rate Limits.

500Internal Server Error
Content-Type: application/json
Error

Internal Server Error. Returns ErrorResponse.

Discussion

Advertiser resources are brands and content providers available across your organization that you can delegate to an ad account. This endpoint returns all resources visible to the authenticated caller for the given resourceType. It takes no account-scoping parameter. The resourceType query parameter is required. Omitting it returns an error. See AdvertiserResourceType for supported values.

Each resource in the response identifies itself by its resourceId, resourceType, and resourceName. Use the returned resourceId values when creating or updating delegations on an ad account via Update Ad Accounts.

Payload Examples

See Also