Query events (v2)

get

https://api.delivr.ai/api/v2/events

Retrieve events scoped by source type. Requires source to
distinguish pixel events from DSP events.

Pixel events (source=pixel): Scope with pixel_id or
project_id (same as v1).

DSP events (source=dsp): Scope with campaign_id.
Bearer token auth requires project_id alongside campaign_id.

Responses include the same proxy transforms as v1 (title
casing, field renaming).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

source

string

enum

Defaults to pixel

Event source type: pixel or dsp. Defaults to pixel if omitted.

Allowed:

pixel_id

string

Pixel identifier. Use with source=pixel.

project_id

string

Project identifier. Queries all pixels in the project (source=pixel). Also required alongside campaign_id for Bearer token auth (source=dsp).

campaign_id

string

Campaign identifier. Use with source=dsp. Bearer token auth requires project_id alongside campaign_id.

start_ms

int64

Inclusive start timestamp in milliseconds since epoch.

end_ms

int64

Inclusive end timestamp in milliseconds since epoch.

limit

integer

≥ 1

Maximum number of rows to return.

offset

integer

≥ 0

Number of rows to skip before returning results.

select

string

Comma-separated column list to project specific fields.

filter

string

Filter expression using <field>:<op>:<value> syntax.

distinct

string

Comma-separated list of fields to deduplicate the result set.

include_cold

boolean

Defaults to false

When true, also read date partitions older than the event store's local retention window from cold storage (S3), and allow a longer time window. Works for any source (pixel or dsp). Off by default.

Responses

400

Invalid parameters.

401

Missing or invalid authentication.

500

Internal server error.

200Matching events.