Get event summary

Deprecated. This page documents the v2 buyer API, which is closed to new API clients and switches off on 1 December 2026. Use V3 instead: see Move a v2 buyer REST integration to V3. The conversion endpoint, Log event, stays open.

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.apostra.com/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

Param	Type	Required	Notes
`advertiserId`	string (path)	Yes	Advertiser the events belong to
`eventType`	enum	No	`conversion`, `click`, `impression`, `measurement`, or `mmp`. When omitted, returns all types
`startHour`	string	No	Inclusive, hour-aligned ISO 8601 (`2026-03-27T14:00:00Z`). Defaults to the start of the last completed UTC hour
`endHour`	string	No	Exclusive, 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

Start building

Core Concepts

Buyer operations

Seller operations

Cross-Cutting Reference

Buyer API reference

Seller API reference

Release Notes

Get event summary

Request

Parameters

Response

Errors

Reporting tasks

Get reporting metrics

Reporting overview guide

​Request

​Parameters

​Response

​Errors

​Related

Reporting tasks

Get reporting metrics

Reporting overview guide

Request

Parameters

Response

Errors

Related