Get an upstream media buy for an ad server source
curl --request GET \
--url https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys/{mediaBuyId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys/{mediaBuyId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys/{mediaBuyId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"mediaBuyId": "<string>",
"principalId": "<string>",
"principalName": "<string>",
"status": "<string>",
"flightStartDate": "<string>",
"flightEndDate": "<string>",
"totalBudget": 123,
"currency": "<string>",
"createdAt": "<string>",
"products": [
"<string>"
],
"creatives": [
"<string>"
],
"statusHistory": [
{
"occurredAt": "<string>",
"status": "<string>",
"note": "<string>"
}
],
"buyerRef": "<string>",
"deliveredImpressions": 0,
"deliveredSpend": 123,
"pacing": "<string>",
"targeting": {}
}{
"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": {}
}
}Storefront Ad Server Diagnostics
Get an upstream media buy for an ad server source
Fetch one persisted upstream media buy for the ad server source, including status, delivery snapshot fields, products, targeting, creatives, and status history.
GET
/
esa
/
{esaId}
/
media-buys
/
{mediaBuyId}
Get an upstream media buy for an ad server source
curl --request GET \
--url https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys/{mediaBuyId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys/{mediaBuyId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys/{mediaBuyId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"mediaBuyId": "<string>",
"principalId": "<string>",
"principalName": "<string>",
"status": "<string>",
"flightStartDate": "<string>",
"flightEndDate": "<string>",
"totalBudget": 123,
"currency": "<string>",
"createdAt": "<string>",
"products": [
"<string>"
],
"creatives": [
"<string>"
],
"statusHistory": [
{
"occurredAt": "<string>",
"status": "<string>",
"note": "<string>"
}
],
"buyerRef": "<string>",
"deliveredImpressions": 0,
"deliveredSpend": 123,
"pacing": "<string>",
"targeting": {}
}{
"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
Ad server source connection id. The wire field remains esaId for API compatibility.
Required range:
0 < x <= 9007199254740991Example:
123
Upstream media buy id for the ad server source.
Minimum string length:
1Example:
"adcp_mb_123"
Response
Get an upstream media buy for an ad server source
Show child attributes
Show child attributes
Required range:
-9007199254740991 <= x <= 9007199254740991Show child attributes
Show child attributes