Skip to main content
GET
/
esa
/
{esaId}
/
media-buys
List upstream ESA media buys
curl --request GET \
  --url https://api.interchange.io/api/v2/storefront/esa/{esaId}/media-buys \
  --header 'Authorization: Bearer <token>'
{
  "mediaBuys": [
    {
      "mediaBuyId": "<string>",
      "principalId": "<string>",
      "principalName": "<string>",
      "status": "<string>",
      "flightStartDate": "<string>",
      "flightEndDate": "<string>",
      "totalBudget": 123,
      "currency": "<string>",
      "createdAt": "<string>",
      "buyerRef": "<string>",
      "deliveredImpressions": 0,
      "deliveredSpend": 123,
      "pacing": "<string>"
    }
  ],
  "count": 4503599627370495,
  "nextCursor": "<string>"
}

Authorizations

Authorization
string
header
required

API key or access token

Path Parameters

esaId
integer
required

Embedded sales agent connection id.

Required range: x <= 9007199254740991
Example:

123

Query Parameters

status
string
principalId
string
fromDate
string
toDate
string
limit
integer
Required range: x <= 100
cursor
string

Response

List upstream ESA media buys

mediaBuys
object[]
required
count
integer
required
Required range: 0 <= x <= 9007199254740991
nextCursor
string | null