> ## 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 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. ## OpenAPI ````yaml openapi/advertiser-reporting.yaml post /advertisers/reporting/conversions openapi: 3.0.3 info: title: Everflow Advertiser API - Reporting description: > Reporting endpoints for the Everflow Advertiser API. These endpoints are accessed by advertiser users using their own API key and return data scoped to the authenticated advertiser's account only. version: 1.0.0 servers: - description: Production Server url: https://api.eflow.team/v1 security: [] tags: - name: Advertiser Reporting description: Reporting endpoints available to advertiser users. paths: /advertisers/reporting/conversions: post: tags: - Advertiser Reporting summary: Search Conversions parameters: - in: query name: page schema: type: integer default: 1 description: Page number (1-based). - in: query name: page_size schema: type: integer default: 50 description: Number of results per page. requestBody: required: true content: application/json: example: show_conversions: true show_events: false show_only_vt: false show_only_ct: false from: '2024-01-01' to: '2024-01-31' timezone_id: 67 currency_id: USD query: filters: [] search_terms: [] schema: type: object required: - show_conversions - show_events - from - to - timezone_id - currency_id properties: show_conversions: type: boolean description: Whether to include base conversions in the results. show_events: type: boolean description: Whether to include post-conversion events in the results. show_only_vt: type: boolean description: When true, only return view-through conversions. show_only_ct: type: boolean description: When true, only return click-through conversions. from: type: string description: Start date. Format `YYYY-MM-DD` or `YYYY-MM-DD hh:mm:ss`. to: type: string description: End date. Format `YYYY-MM-DD` or `YYYY-MM-DD hh:mm:ss`. timezone_id: type: integer description: Timezone identifier for the request. currency_id: type: string description: Currency code for monetary values (e.g. "USD"). query: type: object description: Query configuration for filtering. properties: filters: type: array description: Filters to narrow results. items: type: object properties: filter_id_value: type: string description: The value to filter on. resource_type: type: string description: The resource type to filter on. search_terms: type: array description: Text-based search filters. items: type: object properties: search_type: type: string description: The field to search on. value: type: string description: The search term. responses: '200': description: '' content: application/json: schema: type: object properties: conversions: type: array description: Array of conversion objects. items: $ref: '#/components/schemas/Conversion' paging: type: object properties: page: type: integer description: Current page number. page_size: type: integer description: Number of results per page. total_count: type: integer description: Total number of matching conversions. security: - API Key: [] components: schemas: Conversion: type: object description: A single conversion record with full details. properties: conversion_id: type: string description: Unique conversion ID (UUID string). conversion_unix_timestamp: type: integer description: Unix timestamp of when the conversion occurred. cost_type: type: string description: Cost type for this conversion (e.g. cpa, cpc). cost: type: number description: Cost amount for this conversion. sale_amount: type: number description: Sale amount associated with this conversion. conversion_user_ip: type: string description: IP address of the converting user. session_user_ip: type: string description: IP address at time of the original click session. http_user_agent: type: string description: HTTP user agent string of the converting user. country: type: string description: Country of the converting user. region: type: string description: Region/state of the converting user. city: type: string description: City of the converting user. dma: type: integer description: Designated Market Area code. carrier: type: string description: Mobile carrier name. platform: type: string description: Operating system platform. os_version: type: string description: Operating system version. device_type: type: string description: Device type (e.g. desktop, mobile, tablet). browser: type: string description: Browser name. language: type: string description: Browser language. isp: type: string description: Internet service provider. adv1: type: string description: Advertiser sub-parameter 1. adv2: type: string description: Advertiser sub-parameter 2. adv3: type: string description: Advertiser sub-parameter 3. adv4: type: string description: Advertiser sub-parameter 4. adv5: type: string description: Advertiser sub-parameter 5. adv6: type: string description: Advertiser sub-parameter 6. adv7: type: string description: Advertiser sub-parameter 7. adv8: type: string description: Advertiser sub-parameter 8. adv9: type: string description: Advertiser sub-parameter 9. adv10: type: string description: Advertiser sub-parameter 10. transaction_id: type: string description: Click transaction ID associated with this conversion. is_event: type: boolean description: >- Whether this is a post-conversion event (true) or base conversion (false). event: type: string description: Event identifier string. click_unix_timestamp: type: integer description: Unix timestamp of the original click. currency_id: type: string description: Currency code (e.g. "USD"). order_id: type: string description: Order ID associated with this conversion. brand: type: string description: Device brand/manufacturer. coupon_code: type: string description: Coupon code used for this conversion. relationship: type: object description: Related entities for this conversion. properties: offer: type: object description: The offer associated with this conversion. properties: network_offer_id: type: integer description: Offer ID. network_id: type: integer description: Network ID. name: type: string description: Offer name. offer_status: type: string description: Current status of the offer. affiliate: type: object description: The affiliate associated with this conversion. properties: network_affiliate_id: type: integer description: Affiliate ID. network_id: type: integer description: Network ID. name: type: string description: Affiliate name. account_status: type: string description: Affiliate account status. events_count: type: integer description: Number of events associated with this conversion. offer_url: type: object description: The offer URL associated with this conversion. source_id: type: string description: Source ID. affiliate_id: type: integer description: Affiliate ID. sub1: type: string description: Sub-placement value 1. sub2: type: string description: Sub-placement value 2. sub3: type: string description: Sub-placement value 3. sub4: type: string description: Sub-placement value 4. sub5: type: string description: Sub-placement value 5. sub6: type: string description: Sub-placement value 6. sub7: type: string description: Sub-placement value 7. sub8: type: string description: Sub-placement value 8. sub9: type: string description: Sub-placement value 9. sub10: type: string description: Sub-placement value 10. securitySchemes: API Key: description: > 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. in: header name: X-Eflow-Api-Key type: apiKey ````