Skip to main content
GET
Get ad status

Overview

Return the current delivery status so Targeter can sync campaign state. Targeter polls this while a campaign is live and after pause, resume, or review.

Status values

Request

Headers

  • Authorization: Bearer {token} (required)

Path Parameters

string
required
Publisher-generated ad id returned from Create ad

Example Request

Response

Success (200)

string
Publisher-generated ad id
string
Current delivery status
string
UTC timestamp of the last status change

Error Responses

401 - Unauthorized

404 - Ad not found

500 - Server Error

Authorizations

Authorization
string
header
required

API token issued to Targeter during integration setup. Send as Authorization: Bearer <token>.

Path Parameters

ad_id
string
required

Publisher-generated ad id returned from POST /ads

Response

Current ad status

ad_id
string
required
Example:

"ad_9pL2wR"

status
enum<string>
required

Delivery status of the ad

Available options:
draft,
pending_review,
scheduled,
active,
paused,
completed,
rejected,
error
Example:

"active"

updated_at
string<date-time>
Example:

"2026-08-19T09:00:00Z"