> ## 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 Traffic Controls

Retrieve all network-level traffic controls. Traffic controls allow you to set rules for blocking or filtering traffic based on various criteria such as geographic location, device type, or custom variables.


## OpenAPI

````yaml openapi/traffic-controls.yaml get /networks/trafficcontrols
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/trafficcontrols:
    get:
      tags:
        - Traffic Controls
      summary: List Traffic Controls
      responses:
        '200':
          description: ''
          content:
            application/json:
              example:
                traffic_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
                    targeting_action: block
                    date_valid_from: ''
                    date_valid_to: ''
                    comparison_method: exact_match
                    variables: []
                    time_created: 1774721611
                    time_saved: 1774721611
                    relationship:
                      network_offer_ids: null
                      network_affiliate_ids: null
                      network_advertiser_ids: null
                paging:
                  page: 1
                  page_size: 500
                  total_count: 1
              schema:
                type: object
                properties:
                  traffic_controls:
                    type: array
                    items:
                      $ref: '#/components/schemas/TrafficControl'
                  paging:
                    $ref: '#/components/schemas/Paging'
      security:
        - API Key: []
components:
  schemas:
    TrafficControl:
      type: object
      properties:
        network_traffic_control_id:
          type: integer
          description: Unique traffic control ID.
        network_id:
          type: integer
          description: Network ID.
        name:
          type: string
          description: Name of the traffic control.
        status:
          type: string
          enum:
            - active
            - inactive
          description: Status of the traffic control.
        control_type:
          type: string
          enum:
            - blacklist
            - whitelist
          description: Traffic controls can be either whitelist or blacklist.
        targeting_action:
          type: string
          enum:
            - block
            - fail_traffic
          description: The targeting action.
        is_apply_all_offers:
          type: boolean
          description: Whether this control applies to all offers.
        is_apply_all_affiliates:
          type: boolean
          description: Whether this control applies to all affiliates.
        comparison_method:
          type: string
          enum:
            - exact_match
            - contains
            - begins_with
            - ends_with
            - does_not_contain
            - does_not_match
            - is_empty
          description: Defines how the variables are compared.
        variables:
          type: array
          items:
            type: string
            enum:
              - sub1
              - sub2
              - sub3
              - sub4
              - sub5
              - sub6
              - sub7
              - sub8
              - sub9
              - sub10
              - source_id
              - referrer
              - isp
              - ip
              - user_agent
              - country
              - tracking_domain
          description: >
            The click variable that will be looked up and compared to the values
            supplied. Can be one or multiple values among: `sub1`, `sub2`,
            `sub3`, `sub4`, `sub5`, `sub6`, `sub7`, `sub8`, `sub9`, `sub10`,
            `source_id`, `referrer`, `isp`, `ip`, `user_agent`, `country`,
            `tracking_domain`. Note: `variables` and `values` are only populated
            by the Get by ID endpoint.
        relationship:
          type: object
          description: Related entities associated with this traffic control.
          properties:
            network_offer_ids:
              type: array
              items:
                type: integer
              nullable: true
              description: Offer IDs this control applies to.
            network_affiliate_ids:
              type: array
              items:
                type: integer
              nullable: true
              description: Affiliate IDs this control applies to.
            network_advertiser_ids:
              type: array
              items:
                type: integer
              nullable: true
              description: Advertiser IDs this control applies to.
            values:
              type: array
              items:
                type: string
              description: >
                The blocked/allowed values. Only returned by the Find by ID
                endpoint.
        date_valid_from:
          type: string
          description: Start date for the control's validity period (YYYY-MM-DD).
        date_valid_to:
          type: string
          description: End date for the control's validity period (YYYY-MM-DD).
        time_created:
          type: integer
          example: 1734455015
          description: Unix timestamp of creation.
        time_saved:
          type: integer
          example: 1734455015
          description: Unix timestamp of last update.
    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

````