API referenceLaunches

Get ad delivery status

Returns review and delivery status from the ad platform for every live entity in the launch: issues lists each ad that is disapproved, in review or has limited delivery, and adsetStatuses and campaignStatuses give the status of every live ad set and campaign. Values are live reads from the ad platform.

GET
/v1/brands/{brandId}/launches/{launchId}/delivery-status

Authorization

bearerAuth
headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

Path Parameters

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

launchId*string

The campaign launch (batch) id.

Response Body

Get ad delivery status

application/json
  1. response
issues*array<>
coverage*string
Value in"CHECKED""NO_LIVE_ENTITIES"
adsChecked?number
adsetStatuses*array<>
campaignStatuses*array<>
[key: string]?unknown
curl -X GET "https://example.com/v1/brands/0/launches/string/delivery-status" \  -H "Authorization: Bearer koast_sk_..."
{  "issues": [    {      "adId": "string",      "effectiveStatus": "string",      "reasons": [        "string"      ],      "internalId": "string",      "name": "string",      "property1": null,      "property2": null    }  ],  "coverage": "CHECKED",  "adsChecked": 0,  "adsetStatuses": [    {      "adsetId": "string",      "metaAdsetId": "string",      "effectiveStatus": "string",      "name": "string",      "property1": null,      "property2": null    }  ],  "campaignStatuses": [    {      "campaignId": "string",      "metaCampaignId": "string",      "effectiveStatus": "string",      "name": "string",      "property1": null,      "property2": null    }  ],  "property1": null,  "property2": null}

Required scope: read. CLI: koast get-ad-delivery-status, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.

Distribute creative

Places one creative (creativeId) on many ad sets at once: those in targets.adsetIds and every ad set under the campaigns in targets.campaignIds. With strategy: newAdPerTarget a new ad is created in each ad set; with replaceFirstAd the creative replaces the one on each ad set's first ad, or a new ad is created when the ad set has none.

Get daily insights

Returns daily insights for the launch, one row per day summed across every entity at level: spend, impressions, clicks, reach, frequency, hook and hold rate, results, CPA, CTR (all clicks) and CPM. The window is the last days days, or startDate to endDate when both are given. reach is null when more than one entity is summed. Values are live reads from the ad platform.