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

# Find Traffic Controls (Advanced)

Retrieve a paginated list of traffic controls with search and filter support. Unlike the basic GET endpoint, this returns traffic controls with additional filter capabilities.

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/traffic-controls.yaml post /networks/trafficcontrolstable
openapi: 3.0.3
info:
  title: Everflow Network API - Traffic Controls
  description: >
    Endpoints for managing network-level traffic controls. Traffic controls are
    rules that filter incoming traffic based on variables like device type, geo,
    or referrer — they help block fraudulent or low-quality traffic before it
    reaches your offers. For a full overview, see the [Traffic Controls
    guide](https://helpdesk.everflow.io/customer/traffic-controls).
  version: 1.0.0
servers:
  - url: https://api.eflow.team/v1
security: []
tags:
  - name: Traffic Controls
paths:
  /networks/trafficcontrolstable:
    post:
      tags:
        - Traffic Controls
      summary: Find Traffic Controls (Advanced)
      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:
              search_terms:
                - search_type: name
                  value: search query
              filters:
                status: active
                network_offer_ids:
                  - 1
            schema:
              type: object
              properties:
                search_terms:
                  type: array
                  description: Text search filters.
                  items:
                    type: object
                    required:
                      - search_type
                      - value
                    properties:
                      search_type:
                        type: string
                        enum:
                          - name
                        description: >
                          The name of the field used for search. Currently only
                          supports "name".
                      value:
                        type: string
                        description: The value to search.
                filters:
                  type: object
                  description: Filters to narrow down the set of traffic controls returned.
                  properties:
                    status:
                      type: string
                      enum:
                        - active
                        - inactive
                      description: Status of the traffic controls.
                    network_offer_ids:
                      type: array
                      items:
                        type: integer
                      description: >
                        IDs of the offers affected by the traffic controls
                        (traffic controls that apply to all offers will be
                        included).
                    network_affiliate_ids:
                      type: array
                      items:
                        type: integer
                      description: >
                        IDs of the affiliates affected by the traffic controls
                        (traffic controls that apply to all affiliates will be
                        included).
      responses:
        '200':
          description: ''
          content:
            application/json:
              example:
                controls:
                  - network_traffic_control_id: 1
                    network_id: 1
                    name: Block Bad Sources
                    status: active
                    is_apply_all_affiliates: true
                    is_apply_all_offers: true
                    control_type: blacklist
                    time_created: 1774721611
                    time_saved: 1774721611
                    network_offer_ids: null
                    network_affiliate_ids: null
                    network_advertiser_ids: null
                paging:
                  page: 1
                  page_size: 50
                  total_count: 1
              schema:
                type: object
                properties:
                  controls:
                    type: array
                    items:
                      type: object
                      properties:
                        network_traffic_control_id:
                          type: integer
                        network_id:
                          type: integer
                        name:
                          type: string
                        status:
                          type: string
                        is_apply_all_affiliates:
                          type: boolean
                        is_apply_all_offers:
                          type: boolean
                        control_type:
                          type: string
                        time_created:
                          type: integer
                          example: 1734455015
                        time_saved:
                          type: integer
                          example: 1734455015
                        network_offer_ids:
                          type: array
                          nullable: true
                          items:
                            type: integer
                        network_affiliate_ids:
                          type: array
                          nullable: true
                          items:
                            type: integer
                        network_advertiser_ids:
                          type: array
                          nullable: true
                          items:
                            type: integer
                  paging:
                    $ref: '#/components/schemas/Paging'
      security:
        - API Key: []
components:
  schemas:
    Paging:
      type: object
      properties:
        page:
          type: integer
          description: Current page number.
        page_size:
          type: integer
          description: Number of items per page.
        total_count:
          type: integer
          description: Total number of items.
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````