Skip to main content
POST
Search Conversions
Search raw conversion data with flexible filtering. Each conversion is returned as a separate row with full details including geo-location, device info, and advertiser parameters (adv1-adv10). Each request must contain from and to dates, a timezone_id, and boolean flags for show_conversions and show_events. The conversion report is limited to the prior 365 days and a maximum duration of one year. Requests outside of this range will result in an error.

Authorizations

X-Eflow-Api-Key
string
header
required

The advertiser's API key generated from the Advertiser Portal. Uses the same X-Eflow-Api-Key header as other Everflow APIs, but the key belongs to the advertiser user rather than the network admin.

Query Parameters

page
integer
default:1

Page number (1-based).

page_size
integer
default:50

Number of results per page.

Body

application/json
show_conversions
boolean
required

Whether to include base conversions in the results.

show_events
boolean
required

Whether to include post-conversion events in the results.

from
string
required

Start date. Format YYYY-MM-DD or YYYY-MM-DD hh:mm:ss.

to
string
required

End date. Format YYYY-MM-DD or YYYY-MM-DD hh:mm:ss.

timezone_id
integer
required

Timezone identifier for the request.

currency_id
string
required

Currency code for monetary values (e.g. "USD").

show_only_vt
boolean

When true, only return view-through conversions.

show_only_ct
boolean

When true, only return click-through conversions.

query
object

Query configuration for filtering.

Response

200 - application/json
conversions
object[]

Array of conversion objects.

paging
object