<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/GET-campaigns-_id_",
  "metadataVersion" : "0.1.0",
  "role" : "Web Service Endpoint",
  "symbol" : {
    "kind" : "Web Service Endpoint",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "rest:apple-ads-platform-api:get:campaigns-{}"
  },
  "title" : "Get a Campaign"
}
-->

# Get a Campaign

Retrieve a single campaign by its unique identifier.

## Discussion

This endpoint retrieves a single campaign by its ID and returns the latest persisted state of the [`Campaign`](/documentation/Apple-Ads-Platform-API/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

**App Store Campaign:**

### Request

Response for a campaign promoting an App Store app. The `promotedObjectType` field is `APPSTORE_APP` and `promotedObjectId` is the app’s `adamId`.

```
GET https://api.ads.apple.com/v1/campaigns/444555681
```

### Response

```json
{
 "result": {
   "id": 444555681,
   "name": "AwayFinder App Campaign",
   "adAccountId": 123456789,
   "promotedObjectType": "APPSTORE_APP",
   "promotedObjectId": "123456789",
   "status": "ENABLED",
   "billingEvent": "TAPS",
   "startTime": "2025-09-01T00:00:00.000",
   "endTime": "2025-12-31T23:59:59.000",
   "dailyBudget": {
     "value": {
       "amount": "100.00",
       "currency": "USD"
     }
   },
   "targeting": {
     "countryOrRegion": {
       "include": [
         "US"
       ]
     },
     "supplyPlacement": {
       "include": [
         "APPSTORE_SEARCH_RESULTS"
       ]
     }
   },
   "bidStrategy": {
     "bidStrategyType": "MAX_CONVERSIONS",
     "bidStrategyGoal": "INSTALL"
   },
   "regulationResponses": [
     {
       "regulationType": "CAMPAIGN_SAPIN_LAW",
       "responseValue": "NOT_AGENT"
     }
   ],
   "creationTime": "2025-01-10T08:00:00.000",
   "modificationTime": "2025-01-10T08:00:00.000",
   "deleted": false,
   "paymentModel": "PAYG",
   "systemStatus": "RUNNING",
   "systemStatusReasons": [],
   "systemStatusLimitingReasons": [],
   "displayStatus": "RUNNING"
 }
}
```

**Apple Maps Campaign:**

### Request

Response for a campaign promoting a brand on Apple Maps. The `promotedObjectType` field is `BUSINESS_BRAND` and `promotedObjectId` is the brand’s unique ID.

```
GET https://api.ads.apple.com/v1/campaigns/111222333
```

### Response

```json
{
 "result": {
   "id": 111222333,
   "name": "AwayFinder Apple Maps Campaign",
   "adAccountId": 123456789,
   "promotedObjectType": "BUSINESS_BRAND",
   "promotedObjectId": "987654321",
   "status": "ENABLED",
   "billingEvent": "TAPS",
   "startTime": "2025-09-01T00:00:00.000",
   "endTime": "2025-12-31T23:59:59.000",
   "dailyBudget": {
     "value": {
       "amount": "900.00",
       "currency": "USD"
     }
   },
   "targeting": {
     "supplySource": {
       "include": [
         "MAPS"
       ]
     },
     "supplyPlacement": {
       "include": [
         "MAPS_SEARCH_RESULTS"
       ]
     }
   },
   "bidStrategy": {
     "bidStrategyType": "MAX_ENGAGEMENTS",
     "bidStrategyGoal": "TAP"
   },
   "creationTime": "2025-01-15T10:30:00.000",
   "modificationTime": "2025-01-20T14:45:00.000",
   "deleted": false,
   "paymentModel": "PAYG",
   "systemStatus": "RUNNING",
   "systemStatusReasons": [],
   "systemStatusLimitingReasons": [],
   "displayStatus": "RUNNING"
 }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)