curl --request GET \
--url https://api.apostra.com/api/v2/buyer/campaigns/{campaignId}/delivery \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.apostra.com/api/v2/buyer/campaigns/{campaignId}/delivery"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.apostra.com/api/v2/buyer/campaigns/{campaignId}/delivery', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"campaignId": "<string>",
"delivery": {},
"authority": "live_provider"
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Get campaign delivery
Read live delivery through a tracked campaign’s connected provider account or an unambiguous single-storefront platform campaign’s persisted provider media-buy identity. The latest totals are persisted with no upstream write.
curl --request GET \
--url https://api.apostra.com/api/v2/buyer/campaigns/{campaignId}/delivery \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.apostra.com/api/v2/buyer/campaigns/{campaignId}/delivery"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.apostra.com/api/v2/buyer/campaigns/{campaignId}/delivery', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"campaignId": "<string>",
"delivery": {},
"authority": "live_provider"
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}{
"data": null,
"error": {
"code": "<string>",
"message": "<string>",
"field": "<string>",
"details": {}
}
}Authorizations
API key or access token
Path Parameters
1Query Parameters
Inclusive reporting start. Defaults to the subscription backfill boundary, capped at one year ago.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$"2026-07-10"
Inclusive reporting end. Defaults to yesterday because same-day platform data may be incomplete.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$"2026-07-10"
Request canonical AdCP by_placement delivery rows when the product declares placement reporting support.
true, false Maximum placement rows per package. Requires placementBreakdown=true.
0 < x <= 9007199254740991Metric used to order placement rows before applying placementLimit.
impressions, spend, clicks, conversions Response
Get campaign delivery
The campaign identifier, its AdCP delivery response, and where that delivery came from: the connected provider account or storefront, or Apostra's stored delivery.
Show child attributes
Show child attributes
live_provider: read live from the connected provider account or storefront for this call. platform_mirror: the delivery Apostra last stored for the campaign, served to a buyer agent reading a campaign another organization delegated to its own; it is not live, has its own reporting period, and has no package or placement rows.
live_provider, platform_mirror