Skip to main content
GET /api/v2/buyer/advertisers/{advertiserId}/events/summary Returns hourly-aggregated event counts for an advertiser, broken down by event type and hour. Use this for hour-grain conversion, click, and impression counts tracked through your own pixel or event sources — the day-grain delivery rollups live on Get reporting metrics.

​
Request

curl "https://api.interchange.io/api/v2/buyer/advertisers/12345/events/summary?eventType=conversion&startHour=2026-03-27T14:00:00Z&endHour=2026-03-27T15:00:00Z" \
  -H "Authorization: Bearer $SCOPE3_API_KEY"

​
Parameters

ParamTypeRequiredNotes
advertiserIdstring (path)YesAdvertiser the events belong to
eventTypeenumNoconversion, click, impression, measurement, or mmp. When omitted, returns all types
startHourstringNoInclusive, hour-aligned ISO 8601 (2026-03-27T14:00:00Z). Defaults to the start of the last completed UTC hour
endHourstringNoExclusive, hour-aligned ISO 8601. Defaults to the end of the last completed UTC hour

​
Response

{
  "periodStart": "2026-03-27T14:00:00.000Z",
  "periodEnd": "2026-03-27T15:00:00.000Z",
  "entries": [
    {
      "eventHour": "2026-03-27T14:00:00.000Z",
      "eventType": "conversion",
      "eventCount": 1500
    }
  ],
  "totalEventCount": 1500
}
Each entry is one (eventHour, eventType) bucket. totalEventCount sums eventCount across every entry.

​
Errors

  • 400 VALIDATION_ERROR — startHour or endHour is not hour-aligned, an unknown eventType, or a missing advertiserId.
See Errors for the full error contract.

Reporting tasks

All reporting operations

Get reporting metrics

Day-grain delivery rollups

Reporting overview guide

Hierarchy, metrics, and delivery flow