REST API · Structure

Get latest in campaign

The most recently created ad set and ad of a campaign ("copy the latest")

GEThttps://api.apogee.ad/api/v1/ad-accounts/{acc}/campaigns/{id}/latest

Scope: read Pro and Scale plans Credits: Free*

What it does

Their ids, names and creation times. A launch plan copies them with copy_adset_from / copy_ad_from (GET /adsets/{id}/template and /ads/{id}/template show what each one holds). null when the campaign has none.

Request

GET /ad-accounts/{acc}/campaigns/{id}/latest on https://api.apogee.ad/api/v1.

Path parameters

acc string path required

Meta ad account id (act_…)

Matches ^(act_)?\d{1,32}$
id string path required

Campaign id

Matches ^\d{1,40}$

Headers

Authorization string header required

Bearer apk_…: an API key with the scope of this route.

Response

200.

campaign_id string
adset object or null
Fields (4)
- id string
- name string or null
- status string or null
- created_time string or null
ad object or null
Fields (5)
- id string
- name string or null
- status string or null
- adset_id string or null
- created_time string or null
use object
Fields (2)
- copy_adset_from string
- copy_ad_from string
note string

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Status	Possible codes
400 Bad request	`idempotency_key_required`, `not_supported`, `request_refused`, `validation_failed`
401 Unauthorized	`invalid_api_key`
403 Forbidden	`account_not_connected`, `forbidden`, `insufficient_scope`, `meta_permission_denied`, `platform_permission_denied`, `upgrade_required`
404 Not found	`not_found`
412 Precondition failed	`drive_not_connected`, `meta_not_connected`, `platform_not_connected`
429 Too many requests	`daily_read_cap`, `meta_rate_limited`, `platform_rate_limited`, `quota_exceeded`, `rate_limited`
500 Internal server error	`internal_error`
502 Bad gateway	`drive_error`, `launch_failed`, `meta_error`, `platform_error`, `upstream_error`

Example

With your key in APOGEE_API_KEY (create one):

Request

curl 'https://api.apogee.ad/api/v1/ad-accounts/act_1234567890/campaigns/120200000000000001/latest' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

Response 200 (shape)

{
  "campaign_id": "120200000000000001",
  "adset": {
    "id": "120200000000000001",
    "name": "Nordlicht | Spring launch",
    "status": "ACTIVE",
    "created_time": "09:00"
  },
  "ad": {
    "id": "120200000000000001",
    "name": "Nordlicht | Spring launch",
    "status": "ACTIVE",
    "adset_id": "120200000000000002",
    "created_time": "09:00"
  },
  "use": {
    "copy_adset_from": "120200000000000001",
    "copy_ad_from": "120200000000000001"
  },
  "note": "Example text"
}

Access and cost

Plans	Pro and Scale.
Scope	`read` (scopes).
Credits	Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A request that fails costs nothing, a replayed one neither (credits).
Rate limit	Read: 600 per 15 minutes on Pro, 1,200 on Scale (rate limits).
Meta budget	Reads Meta: spends 1 unit of the account's Meta budget (1,800 per 15 minutes, 900 per ad account).
Daily cap	Counts 1 unit toward the 2,000 units one API key can use in 24 hours.

In the MCP

An AI assistant does the same with this tool of the MCP server:

get_latest_in_campaign: The newest ad set and ad of a campaign, by creation time: "copy the latest ad set and ad of campaign X". Their ids go in prepare_launch copy_adset_from and copy_ad_from.

List campaigns: GET /ad-accounts/{acc}/campaigns
List ad sets: GET /ad-accounts/{acc}/adsets
List ads: GET /ad-accounts/{acc}/ads
Get an ad set template: GET /adsets/{id}/template
Get ad template: GET /ads/{id}/template

What it does

Request

Path parameters

Headers

Response

Errors

Example

Access and cost

In the MCP

Related operations