> ## Documentation Index
> Fetch the complete documentation index at: https://developers.everflow.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Conversions

Returns a list of individual conversions and/or events for the authenticated affiliate. Each conversion is returned as a separate element. Results are paginated and can be filtered by date range, offer, and other dimensions.

Pagination is controlled through the `page` and `page_size` **query parameters**,
not the JSON request body. For example, `?page=2&page_size=100` returns the
second page of 100 conversions.

The date range (`from` / `to`) is limited to the prior **365 days**. Requests with dates older than 365 days will return an error.


## OpenAPI

````yaml openapi/affiliate-reporting.yaml post /affiliates/reporting/conversions
openapi: 3.0.3
info:
  title: Everflow Affiliate API - Reporting
  description: >
    Reporting endpoints for the Everflow Affiliate API. These endpoints are
    accessed by affiliate/partner users using their own API key and return data
    scoped to the authenticated affiliate's account only. For more detail, see
    [Essential Reports For New
    Partners](https://helpdesk.everflow.io/collaborator/essential-reports-for-new-partners)
    in the Help Center.
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Affiliate Reporting
    description: Reporting endpoints available to affiliate users.
paths:
  /affiliates/reporting/conversions:
    post:
      tags:
        - Affiliate Reporting
      summary: Conversion Report
      parameters:
        - in: query
          name: page
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
          description: The page of results to retrieve.
        - in: query
          name: page_size
          required: false
          schema:
            type: integer
            minimum: 1
            default: 50
          description: The number of results to return per page.
      requestBody:
        required: true
        content:
          application/json:
            example:
              from: '2026-03-01'
              to: '2026-03-31'
              timezone_id: 67
              show_conversions: true
              show_events: true
              query:
                filters: []
            schema:
              type: object
              required:
                - from
                - to
                - timezone_id
              properties:
                from:
                  type: string
                  description: >-
                    Start date. Format `YYYY-MM-DD`. Must be within the last 365
                    days.
                to:
                  type: string
                  description: >-
                    End date. Format `YYYY-MM-DD`. Must be within the last 365
                    days.
                timezone_id:
                  type: integer
                  description: Timezone identifier for the date range.
                show_conversions:
                  type: boolean
                  description: >
                    Must be explicitly set to `true` to include conversion
                    records in the response. Does not default to true — omitting
                    this field will return no conversions.
                show_events:
                  type: boolean
                  description: Include post-conversion event records in the response.
                  default: false
                query:
                  type: object
                  description: Query configuration with optional filters.
                  properties:
                    filters:
                      type: array
                      description: Filters to narrow results.
                      items:
                        type: object
                        properties:
                          filter_id_value:
                            type: string
                          resource_type:
                            type: string
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  conversions:
                    type: array
                    description: Array of conversion/event records.
                    items:
                      type: object
                      properties:
                        conversion_id:
                          type: string
                          description: Unique conversion identifier.
                        transaction_id:
                          type: string
                          description: Associated click transaction ID.
                        conversion_unix_timestamp:
                          type: integer
                          description: Unix timestamp of the conversion.
                        click_unix_timestamp:
                          type: integer
                          description: Unix timestamp of the associated click.
                        revenue:
                          type: number
                          description: Revenue for the conversion.
                        sale_amount:
                          type: number
                          description: Sale amount (for revenue share offers).
                        event:
                          type: string
                          description: Event name (for post-conversion events).
                        is_event:
                          type: boolean
                          description: Whether this record is an event.
                        source_id:
                          type: string
                        revenue_type:
                          type: string
                        sub1:
                          type: string
                        sub2:
                          type: string
                        sub3:
                          type: string
                        sub4:
                          type: string
                        sub5:
                          type: string
                        sub6:
                          type: string
                        sub7:
                          type: string
                        sub8:
                          type: string
                        sub9:
                          type: string
                        sub10:
                          type: string
                        adv1:
                          type: string
                        adv2:
                          type: string
                        adv3:
                          type: string
                        adv4:
                          type: string
                        adv5:
                          type: string
                        adv6:
                          type: string
                        adv7:
                          type: string
                        adv8:
                          type: string
                        adv9:
                          type: string
                        adv10:
                          type: string
                        session_user_ip:
                          type: string
                        conversion_user_ip:
                          type: string
                        country:
                          type: string
                        region:
                          type: string
                        city:
                          type: string
                        dma:
                          type: integer
                        carrier:
                          type: string
                        isp:
                          type: string
                        platform:
                          type: string
                        os_version:
                          type: string
                        device_type:
                          type: string
                        brand:
                          type: string
                        browser:
                          type: string
                        language:
                          type: string
                        http_user_agent:
                          type: string
                        referer:
                          type: string
                        app_id:
                          type: string
                        idfa:
                          type: string
                        idfa_md5:
                          type: string
                        idfa_sha1:
                          type: string
                        google_ad_id:
                          type: string
                        google_ad_id_md5:
                          type: string
                        google_ad_id_sha1:
                          type: string
                        android_id:
                          type: string
                        android_id_md5:
                          type: string
                        android_id_sha1:
                          type: string
                        currency_id:
                          type: string
                        is_view_through:
                          type: boolean
                        order_id:
                          type: string
                        coupon_code:
                          type: string
                        relationship:
                          type: object
                          properties:
                            offer:
                              type: object
                              properties:
                                network_offer_id:
                                  type: integer
                                network_id:
                                  type: integer
                                network_tracking_domain_id:
                                  type: integer
                                name:
                                  type: string
                                offer_status:
                                  type: string
                            events_count:
                              type: integer
                              description: >-
                                Number of post-conversion events associated with
                                this conversion.
                  paging:
                    type: object
                    properties:
                      page:
                        type: integer
                      page_size:
                        type: integer
                      total_count:
                        type: integer
      security:
        - API Key: []
components:
  securitySchemes:
    API Key:
      description: >
        The affiliate's API key generated from the Affiliate Portal. Uses the
        same X-Eflow-Api-Key header as the Network API, but the key belongs to
        the affiliate user rather than the network admin.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````