> ## 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 On-Hold Conversions

Returns conversions currently in on-hold status for the authenticated affiliate. On-hold conversions are pending review or approval before being finalized. Use this to track conversions awaiting advertiser or network approval.

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 results.


## OpenAPI

````yaml openapi/affiliate-reporting.yaml post /affiliates/reporting/onhold
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/onhold:
    post:
      tags:
        - Affiliate Reporting
      summary: Search On-Hold Conversions
      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
              query:
                filters: []
            schema:
              type: object
              required:
                - from
                - to
                - timezone_id
              properties:
                from:
                  type: string
                  description: Start date. Format `YYYY-MM-DD`.
                to:
                  type: string
                  description: End date. Format `YYYY-MM-DD`.
                timezone_id:
                  type: integer
                  description: Timezone identifier for the date range.
                show_conversions:
                  type: boolean
                  description: >
                    Must be explicitly set to `true` to include on-hold
                    conversion records in the response.
                show_events:
                  type: boolean
                  description: >-
                    Include on-hold post-conversion event records in the
                    response.
                  default: false
                query:
                  type: object
                  properties:
                    filters:
                      type: array
                      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 on-hold conversion records.
                    items:
                      type: object
                      properties:
                        on_hold_conversion_id:
                          type: string
                          description: Unique on-hold conversion identifier.
                        network_id:
                          type: integer
                          description: Network identifier.
                        holding_period_end:
                          type: integer
                          description: Unix timestamp when the holding period ends.
                        status:
                          type: string
                          description: Status of the on-hold conversion.
                        conversion:
                          type: object
                          description: Nested conversion details.
                          properties:
                            conversion_id:
                              type: string
                            transaction_id:
                              type: string
                            conversion_unix_timestamp:
                              type: integer
                            revenue:
                              type: number
                            sale_amount:
                              type: number
                            event_name:
                              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
                            relationship:
                              type: object
                              properties:
                                offer:
                                  type: object
                                events_count:
                                  type: integer
                  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

````