Query events (v2)

get

https://apiv3.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).

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.

Responses

400

Invalid parameters.

401

Missing or invalid authentication.

500

Internal server error.

Language

Credentials

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Matching events.