Contents

Get a Campaign

Retrieve a single campaign by its unique identifier.

URL

GET https://api.ads.apple.com/v1/campaigns/{id}

Path Parameters

NameTypeDescription
id Requiredstring

Header Parameters

NameTypeDescription
X-Ap-Context Requiredstring

Response Codes

StatusReasonTypeDescription
200OK
Content-Type: application/json
CampaignResponse
400Bad Request
Content-Type: application/json
ErrorResponse
401Unauthorized
Content-Type: application/json
ErrorResponse
403Forbidden
Content-Type: application/json
ErrorResponse
404Not Found
Content-Type: application/json
ErrorResponse
429Too Many Requests
Content-Type: application/json
ErrorResponse
500Internal Server Error
Content-Type: application/json
ErrorResponse

Discussion

This endpoint retrieves a single campaign by its ID and returns the latest persisted state of the Campaign object. The response includes all campaign fields, including promotedObjectType and promotedObjectId, which are read-only (immutable) after being set at campaign creation. Campaigns are returned regardless of their deleted status.

Payload Examples

See Also