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

# List Data Supplements

Returns a paginated list of data supplement records for the network. Supports filtering by supplement source, offer, affiliate, and source ID, as well as text search within supplement details.

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

Required field is `timezone_id`.

Related entities (offer and affiliate basic info) are included in the `relationship` field of each record.


## OpenAPI

````yaml openapi/data-supplements.yaml post /networks/supplements/table
openapi: 3.0.3
info:
  title: Everflow Network API - Data Supplements
  description: >
    Data Supplement endpoints for the Everflow partner marketing platform. Data
    supplements allow you to ingest third-party reporting data (from Appsflyer,
    Adjust, TikTok Ads MBC, Google Ads Cost, and other sources) and merge it
    with your Everflow reporting data. For setup instructions, see the [Data
    Supplement guide](https://helpdesk.everflow.io/customer/data-supplement).
  version: 1.0.0
servers:
  - description: Production Server
    url: https://api.eflow.team/v1
security: []
tags:
  - name: Data Supplements
    description: >-
      Endpoints for creating, reverting, listing, and exporting data supplement
      records.
paths:
  /networks/supplements/table:
    post:
      tags:
        - Data Supplements
      summary: List Data Supplements
      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:
              timezone_id: 90
            schema:
              type: object
              required:
                - 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.
                query:
                  type: object
                  description: Query configuration with optional filters and search terms.
                  properties:
                    filters:
                      type: object
                      description: Filters to narrow results.
                      properties:
                        supplement_source:
                          type: string
                          description: Filter by supplement source type.
                          enum:
                            - appsflyer
                            - adjust
                            - google_ads_cost
                            - tiktok_ads_mbc
                            - generic
                        network_offer_ids:
                          type: array
                          description: Filter by specific offer IDs.
                          items:
                            type: integer
                        network_affiliate_ids:
                          type: array
                          description: Filter by specific affiliate IDs.
                          items:
                            type: integer
                        source_ids:
                          type: array
                          description: Filter by specific source IDs.
                          items:
                            type: integer
                    search_terms:
                      type: array
                      description: Text search terms to match supplement data.
                      items:
                        type: object
                        properties:
                          search_type:
                            type: string
                            description: The field to search.
                            enum:
                              - json_mapping_id
                              - json_mapping_name
                              - appsflyer_event_id
                              - appsflyer_campaign_id
                              - appsflyer_publisher_id
                              - adjust_event_id
                              - adjust_adgroup_id
                              - adjust_partner_id
                              - adjust_campaign_id
                              - adjust_creative_id
                              - json_text
                          value:
                            type: string
                            description: The search value.
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  data_supplements:
                    type: array
                    description: Array of data supplement table records.
                    items:
                      type: object
                      properties:
                        network_data_supplement_id:
                          type: integer
                          description: Unique supplement record ID.
                        network_id:
                          type: integer
                        unix_timestamp:
                          type: integer
                          description: Timestamp the supplement applies to.
                        supplement_source:
                          type: string
                          description: Source integration type.
                        network_offer_id:
                          type: integer
                        network_affiliate_id:
                          type: integer
                        source_id:
                          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
                        currency_id:
                          type: string
                        reporting:
                          type: object
                          description: Reporting metrics.
                        time_created:
                          type: integer
                          example: 1734455015
                          description: Unix timestamp of record creation.
                        source_details:
                          type: string
                          description: Raw source-specific JSON details.
                        relationship:
                          type: object
                          description: Related entities.
                          properties:
                            offer:
                              type: object
                              description: Basic offer information.
                              properties:
                                network_offer_id:
                                  type: integer
                                network_id:
                                  type: integer
                                name:
                                  type: string
                            affiliate:
                              type: object
                              description: Basic affiliate information.
                              properties:
                                network_affiliate_id:
                                  type: integer
                                network_id:
                                  type: integer
                                name:
                                  type: string
                  paging:
                    type: object
                    description: Pagination information.
                    properties:
                      page:
                        type: integer
                      page_size:
                        type: integer
                      total_count:
                        type: integer
      security:
        - API Key: []
components:
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````