---
title: "Search Conversions"
method: POST
path: "/advertisers/reporting/conversions"
tags: ["Advertiser Reporting"]
---

# Search Conversions

`POST /advertisers/reporting/conversions`

## Query parameters

- `page` integer
- `page_size` integer

## Request body

- object
  - `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.
  - `show_only_vt` boolean — When true, only return view-through conversions.
  - `show_only_ct` boolean — When true, only return click-through conversions.
  - `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").
  - `query` object — Query configuration for filtering.
    - `filters` object[] — Filters to narrow results.
      - `filter_id_value` string — The value to filter on.
      - `resource_type` string — The resource type to filter on.
    - `search_terms` object[] — Text-based search filters.
      - `search_type` string — The field to search on.
      - `value` string — The search term.

## Response `200`

- object
  - `conversions` Conversion[] — Array of conversion objects.
    - `conversion_id` string — Unique conversion ID (UUID string).
    - `conversion_unix_timestamp` integer — Unix timestamp of when the conversion occurred.
    - `cost_type` string — Cost type for this conversion (e.g. cpa, cpc).
    - `cost` number — Cost amount for this conversion.
    - `sale_amount` number — Sale amount associated with this conversion.
    - `conversion_user_ip` string — IP address of the converting user.
    - `session_user_ip` string — IP address at time of the original click session.
    - `http_user_agent` string — HTTP user agent string of the converting user.
    - `country` string — Country of the converting user.
    - `region` string — Region/state of the converting user.
    - `city` string — City of the converting user.
    - `dma` integer — Designated Market Area code.
    - `carrier` string — Mobile carrier name.
    - `platform` string — Operating system platform.
    - `os_version` string — Operating system version.
    - `device_type` string — Device type (e.g. desktop, mobile, tablet).
    - `browser` string — Browser name.
    - `language` string — Browser language.
    - `isp` string — Internet service provider.
    - `adv1` string — Advertiser sub-parameter 1.
    - `adv2` string — Advertiser sub-parameter 2.
    - `adv3` string — Advertiser sub-parameter 3.
    - `adv4` string — Advertiser sub-parameter 4.
    - `adv5` string — Advertiser sub-parameter 5.
    - `adv6` string — Advertiser sub-parameter 6.
    - `adv7` string — Advertiser sub-parameter 7.
    - `adv8` string — Advertiser sub-parameter 8.
    - `adv9` string — Advertiser sub-parameter 9.
    - `adv10` string — Advertiser sub-parameter 10.
    - `transaction_id` string — Click transaction ID associated with this conversion.
    - `is_event` boolean — Whether this is a post-conversion event (true) or base conversion (false).
    - `event` string — Event identifier string.
    - `click_unix_timestamp` integer — Unix timestamp of the original click.
    - `currency_id` string — Currency code (e.g. "USD").
    - `order_id` string — Order ID associated with this conversion.
    - `brand` string — Device brand/manufacturer.
    - `coupon_code` string — Coupon code used for this conversion.
    - `relationship` object — Related entities for this conversion.
      - `offer` object — The offer associated with this conversion.
        - `network_offer_id` integer — Offer ID.
        - `network_id` integer — Network ID.
        - `name` string — Offer name.
        - `offer_status` string — Current status of the offer.
      - `affiliate` object — The affiliate associated with this conversion.
        - `network_affiliate_id` integer — Affiliate ID.
        - `network_id` integer — Network ID.
        - `name` string — Affiliate name.
        - `account_status` string — Affiliate account status.
      - `events_count` integer — Number of events associated with this conversion.
      - `offer_url` object — The offer URL associated with this conversion.
      - `source_id` string — Source ID.
      - `affiliate_id` integer — Affiliate ID.
      - `sub1` string — Sub-placement value 1.
      - `sub2` string — Sub-placement value 2.
      - `sub3` string — Sub-placement value 3.
      - `sub4` string — Sub-placement value 4.
      - `sub5` string — Sub-placement value 5.
      - `sub6` string — Sub-placement value 6.
      - `sub7` string — Sub-placement value 7.
      - `sub8` string — Sub-placement value 8.
      - `sub9` string — Sub-placement value 9.
      - `sub10` string — Sub-placement value 10.
  - `paging` object
    - `page` integer — Current page number.
    - `page_size` integer — Number of results per page.
    - `total_count` integer — Total number of matching conversions.

---

[API](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains.md) · [All operations](https://skmtc.net/everflow/apis/everflow-network-api-tracking-domains/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/everflow/everflow-network-api-tracking-domains/revisions/39242cee0e32/schema)