Vast Events

POST /api

Use this method to get your reporting data of the Vast events

Headers

Name	Value
Authorization	Basic <token>

Body

{
  table: "vast_events",
  startDate: string, // (format: YYYY-MM-DDThh:mm:ss)
  endDate: string, // (format: YYYY-MM-DDThh:mm:ss)
  fields: [
    { name: "timestamp", as?: string },
    { name: "account_id", as?: string },
    { name: "account_name", as?: string },
    { name: "site_id", as?: string },
    { name: "site_name", as?: string },
    { name: "tag_id", as?: string },
    { name: "tag_name", as?: string },
    { name: "auction_type", as?: string },
    { name: "os", as?: string },
    { name: "browser", as?: string },
    { name: "device", as?: string },
    { name: "domain", as?: string },
    { name: "country", as?: string },
    { name: "ssp", as?: string },
    { name: "seat", as?: string },
    { name: "adomain", as?: string },
    { name: "deal", as?: string },
  ],
  metrics: [
    { name: "impression", as?: string },
    { name: "start", as?: string },
    { name: "firstquartile", as?: string },
    { name: "midpoint", as?: string },
    { name: "thirdquartile", as?: string },
    { name: "complete", as?: string },
    { name: "creativeview", as?: string },
    { name: "passback", as?: string },
    { name: "empty", as?: string },
    { name: "click", as?: string },
    { name: "error", as?: string }
  ],
  timeSplit: "day" | "hour"
}

200 Valid Request

[
    {
        "timestamp": "2025-06-25T00:00:00.000Z",
        "tag_id": "1",
        "tag_name": "tag_name",
        "site_id": 1,
        "site_name": "site_name",
        "account_id": 1,
        "account_name": "account_name",
        "auction_type": "booster",
        "os": "Android",
        "browser": "Chrome",
        "device": "Mobile",
        "domain": "domain.fr",
        "country": "FR",
        "ssp": "ssp",
        "seat": "1",
        "adomain": "adomain.fr",
        "deal": "deal",
        "impression": "25",
        "start": "25",
        "firstquartile": "24",
        "midpoint": "20",
        "thirdquartile": "18",
        "complete": "18",
        "creativeview": "24",
        "passback": "0",
        "empty": "0",
        "click": "0",
        "error": "0"
    },
]

401 Unauthorized

Unauthorized

400 Bad Request

[
    {
        "message": "'unvalid_name' must be equal to one of the allowed values for table 'vast_events'",
        "params": {
            "allowedValues": [
                "timestamp",
                "auction_type",
                "tag_id",
                "site_id",
                "account_id",
                "tag_name",
                "site_name",
                "account_name",
                "os",
                "browser",
                "device",
                "country",
                "ssp",
                "seat",
                "domain",
                "adomain",
                "deal"
            ]
        }
    }
]