Error
A valid request URL is required to generate request examples{
"advertisers": [
{
"advertiserId": "<string>",
"advertiserName": "<string>",
"metrics": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
},
"mediaBuys": [
{
"mediaBuyId": "<string>",
"name": "<string>",
"status": "<string>",
"budget": 123,
"inventorySourceId": "<string>",
"metrics": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
},
"packages": [
{
"packageId": "<string>",
"productId": "<string>",
"productName": "<string>",
"metrics": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
}
}
]
}
]
}
],
"totals": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
},
"periodStart": "<string>",
"periodEnd": "<string>"
}{
"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": {}
}
}Reporting
Get exact client Source reporting
Returns the standard Storefront reporting contract constrained to one active publisher-authorized Source binding. Demo, download, and caller-selected Source overrides are disabled.
GET
/
provider
/
account
/
connections
/
{bindingUid}
/
reporting
Error
A valid request URL is required to generate request examples{
"advertisers": [
{
"advertiserId": "<string>",
"advertiserName": "<string>",
"metrics": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
},
"mediaBuys": [
{
"mediaBuyId": "<string>",
"name": "<string>",
"status": "<string>",
"budget": 123,
"inventorySourceId": "<string>",
"metrics": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
},
"packages": [
{
"packageId": "<string>",
"productId": "<string>",
"productName": "<string>",
"metrics": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
}
}
]
}
]
}
],
"totals": {
"impressions": 4503599627370495,
"spend": 1,
"clicks": 4503599627370495,
"views": 4503599627370495,
"completedViews": 4503599627370495,
"conversions": 4503599627370495,
"leads": 4503599627370495,
"videoCompletions": 4503599627370495,
"conversionValue": 1,
"ecpm": 123,
"cpc": 123,
"ctr": 123,
"completionRate": 123,
"cpa": 123,
"roas": 123
},
"periodStart": "<string>",
"periodEnd": "<string>"
}{
"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
Pattern:
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$Query Parameters
Start date in ISO format (YYYY-MM-DD)
Pattern:
^\d{4}-\d{2}-\d{2}$Example:
"2026-01-01"
End date in ISO format (YYYY-MM-DD)
Pattern:
^\d{4}-\d{2}-\d{2}$Example:
"2026-01-31"
Number of days to include (default: 7, min: 1, max: 90).
Required range:
1 <= x <= 90Example:
7
Response format: "summary" for hierarchical advertiser/media-buy/package breakdown, "timeseries" for flat per-day rows.
Available options:
summary, timeseries When true, timeseries rows are split by each contributing inventory source. The default preserves the legacy media-buy/package/date row grain.
Available options:
true, false Response
Get exact client Source reporting
- Option 1
- Option 2
Hierarchical storefront reporting response: advertiser → media buy → package
Advertiser-level reporting data
Show child attributes
Show child attributes
Aggregated totals across all advertisers
Show child attributes
Show child attributes
Start of the reporting period (YYYY-MM-DD)
Pattern:
^\d{4}-\d{2}-\d{2}$End of the reporting period (YYYY-MM-DD)
Pattern:
^\d{4}-\d{2}-\d{2}$