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

# Get Traffic Control

> Retrieve a single traffic control by its ID.




## OpenAPI

````yaml openapi/traffic-controls.yaml get /networks/trafficcontrols/{controlId}
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/{controlId}:
    get:
      tags:
        - Traffic Controls
      summary: Get Traffic Control
      description: |
        Retrieve a single traffic control by its ID.
      parameters:
        - in: path
          name: controlId
          required: true
          schema:
            type: integer
          description: The unique traffic control ID.
      responses:
        '200':
          description: ''
          content:
            application/json:
              example:
                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:
                  - source_id
                  - sub3
                time_created: 1774721611
                time_saved: 1774721611
                relationship:
                  network_offer_ids: null
                  network_affiliate_ids: null
                  network_advertiser_ids: null
                  values:
                    - bad_source_1
                    - bad_source_2
              schema:
                $ref: '#/components/schemas/TrafficControl'
        '404':
          description: Traffic control not found.
      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.
  securitySchemes:
    API Key:
      description: The Everflow API key generated from the Control Center > Security.
      in: header
      name: X-Eflow-Api-Key
      type: apiKey

````