Endpoint:
GET /v1/external/campaigns/:campaignId
Required Header:
Authorization: Bearer YOUR_API_TOKEN
Path Parameter:
campaignId
(Number) – The unique ID of the campaign you want to retrieve
Example Request:
GET /v1/external/campaigns/123456
Header: Authorization: Bearer YOUR_API_TOKEN
Example Response:
{
"data": {
"id": 123456,
"name": "Summer Promo 2025",
"bid": 2.5,
"status": "Active",
"app_name": "GameXYZ",
"countries": ["US", "CA"],
"created_at": "2024-04-01T12:00:00Z",
"updated_at": "2024-05-03T14:15:00Z"
}
}
Returned Fields:
id
: Campaign ID (integer)name
: Campaign name (string)bid
: Default bid value (float)status
:Active
,Inactive
, or other lifecycle stageapp_name
: The app associated with the campaigncountries
: Array of targeted countries (ISO 3166-1 alpha-2)created_at
: Timestamp of campaign creation (ISO 8601)updated_at
: Last modified timestamp (ISO 8601)
Possible Errors:
404 –
not found
: No campaign with the specified ID403 –
unauthorized
: Invalid or missing token400 –
invalid ID
: Campaign ID must be a valid number