Skip to main content
GET
Get campaign delivery

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

campaignId
string
required
Minimum string length: 1

Query Parameters

startDate
string<date>

Inclusive reporting start. Defaults to the subscription backfill boundary, capped at one year ago.

Pattern: ^(?:(?:\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])))$
Example:

"2026-07-10"

endDate
string<date>

Inclusive reporting end. Defaults to yesterday because same-day platform data may be incomplete.

Pattern: ^(?:(?:\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])))$
Example:

"2026-07-10"

placementBreakdown
enum<string>

Request canonical AdCP by_placement delivery rows when the product declares placement reporting support.

Available options:
true,
false
placementLimit
integer

Maximum placement rows per package. Requires placementBreakdown=true.

Required range: 0 < x <= 9007199254740991
placementSortBy
enum<string>

Metric used to order placement rows before applying placementLimit.

Available options:
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.

campaignId
string
required
delivery
object
required
authority
enum<string>
required

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.

Available options:
live_provider,
platform_mirror