CampaignsList Campaigns

List Campaigns

List campaigns in a project.

curl -X GET "https://api.5centscdn.com/v2/ad-manager/101/campaigns?page=1&limit=20&q=summer-promo&status=draft&advertiser_id=adv_8f2a&campaign_type=guaranteed_impressions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "result": "success",
  "campaigns": [
    {
      "id": "cmp_4c19",
      "admanager_id": 4019,
      "advertiser_id": "adv_8f2a",
      "advertiser_name": "Acme Corp",
      "name": "Summer Promo 2026",
      "category": "3",
      "campaign_type": "guaranteed_impressions",
      "status": "draft",
      "priority": 50,
      "timezone": "America/New_York",
      "start_at": "2026-06-01T00:00:00-04:00",
      "end_at": "2026-08-31T23:59:59-04:00",
      "pricing_model": "example_string",
      "cpm_micros": 5000000,
      "total_budget_micros": 500000000,
      "daily_budget_cap_micros": 50000000,
      "impression_goal": 1000000,
      "daily_impression_cap": 100000,
      "lifetime_impression_cap": 1000000,
      "pacing_mode": "even",
      "share_of_voice_percent": "25.00",
      "allow_in_pods": 1,
      "max_ads_per_pod": 1,
      "max_seconds_per_pod": 30,
      "allow_multiple_creatives_per_pod": 0,
      "allow_same_creative_repeat": 0,
      "preferred_pod_position": "any",
      "competitive_category": "[10,25]",
      "fallback_allowed": 0,
      "is_house": 0,
      "created_at": "2026-01-15T10:30:00Z",
      "updated_at": "2026-02-01T08:00:00Z",
      "synced_at": "2026-02-01T08:00:00Z"
    }
  ],
  "total": 17,
  "page": 1,
  "pages": 1,
  "stats": {
    "active": 5,
    "draft": 2,
    "paused": 1,
    "archived": 9
  }
}
GET
/ad-manager/{pid}/campaigns
GET
Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: X-API-Key)
X-API-Keystring
Required

API key (sent in header)

path
pidinteger
Required

ID of the Ad Manager project.

query
statusstring
Options: draft, active, paused, archived
query
campaign_typestring
Options: guaranteed_impressions, budget_based, share_of_voice, house
Request Preview
Response

Response will appear here after sending the request

Authentication

header
X-API-Keystring
Required

API Key for authentication. Provide your API key in the header.

Path Parameters

pidinteger
Required

ID of the Ad Manager project.

Example:
101

Query Parameters

pageinteger
Example:
1
limitinteger
Example:
20
qstring
Example:
summer-promo
statusstring
Allowed values:draftactivepausedarchived
advertiser_idstring
Example:
adv_8f2a
campaign_typestring
Allowed values:guaranteed_impressionsbudget_basedshare_of_voicehouse

Responses

resultstring

Operation outcome.

Allowed values:successerror
campaignsarray
totalinteger
pageinteger
pagesinteger
statsobject

Campaign counts keyed by status (e.g. active, draft, paused, archived), used for list banner tiles.