> ## 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 Domain Situation

> The full Traffic Health picture for a single monitored domain — overall state, ownership, expiry, IP-flag status, its open incidents, and rolled-up incident / task / flag counts. The domain must be a monitored tracking or conversion domain; otherwise an `INVALID_ARGUMENT` error is returned.


The full Traffic Health picture for a single monitored domain — overall state, ownership, expiry, its open incidents, and rolled-up incident, task, and flag counts. The domain must be a monitored tracking or conversion domain.


## OpenAPI

````yaml openapi/traffic-health.yaml post /networks/traffic/domains/{domainUrl}/situation
openapi: 3.0.3
info:
  title: Everflow Network API - Traffic Health
  description: >
    Read endpoints for Traffic Health — the operational health of the domains
    and hosting IPs behind your tracking and conversion links. Surfaces uptime /
    SSL / DNS / expiry incidents, blocklist reputation, the remediation tasks
    that need your attention, and per-domain assignment summaries.


    Traffic Health has two tiers. The capabilities available to a network are
    reported by `GET /networks/traffic/access`. Endpoints marked **Traffic
    Health Premium** (domain and IP blocklist reputation) require the premium
    package; on a network without it they return an authorization error rather
    than data.


    For how these incidents and reputation flags work, see [Traffic Health:
    Incidents & Reputation
    Management](https://helpdesk.everflow.io/customer/traffic-health-incidents-and-reputation-management).
  version: 1.0.0
servers:
  - url: https://api.eflow.team/v1
security: []
tags:
  - name: Traffic Health
paths:
  /networks/traffic/domains/{domainUrl}/situation:
    post:
      tags:
        - Traffic Health
      summary: Get Domain Situation
      description: >
        The full Traffic Health picture for a single monitored domain — overall
        state, ownership, expiry, IP-flag status, its open incidents, and
        rolled-up incident / task / flag counts. The domain must be a monitored
        tracking or conversion domain; otherwise an `INVALID_ARGUMENT` error is
        returned.
      parameters:
        - in: path
          name: domainUrl
          required: true
          schema:
            type: string
          description: >-
            The monitored tracking or conversion domain URL (e.g.
            `track.acme.com`).
      requestBody:
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SituationFilter'
      responses:
        '200':
          description: ''
          content:
            application/json:
              example:
                network_id: 1
                url: track.acme.com
                type: down
                domain_type: tracking
                ownership: internal
                is_mps: false
                time_expires: 1797989980
                is_ip_flagged: false
                time_last_uptime_checked: 1782434380
                time_first_uptime_checked: 1782437980
                incidents:
                  - network_id: 1
                    url: track.acme.com
                    identifier: WO8429BKVJ4E7CPE
                    type: certificate_issue
                    status: active
                    time_created: 1781746780
                    time_resolved: 0
                ongoing_incidents_count: 1
                resolved_incidents_count: 0
                action_required_tasks_count: 0
                non_urgent_tasks_count: 0
                completed_tasks_count: 0
                active_flags_count: 0
                removed_flags_count: 0
                mean_time_to_resolution_seconds: 0
              schema:
                $ref: '#/components/schemas/DomainSituation'
      security:
        - API Key: []
components:
  schemas:
    SituationFilter:
      type: object
      description: Optional filters. Send an empty object `{}` for the default rollup.
    DomainSituation:
      type: object
      properties:
        network_id:
          type: integer
        url:
          type: string
        type:
          type: string
          description: Overall state of the domain (`up` or `down`).
        domain_type:
          type: string
        ownership:
          type: string
          description: Ownership / management model (e.g. `internal`).
        is_mps:
          type: boolean
          description: Managed proxy service domain.
        time_expires:
          type: integer
          description: Domain expiry (unix seconds).
        is_ip_flagged:
          type: boolean
          description: Whether a hosting IP is currently flagged.
        time_last_uptime_checked:
          type: integer
        time_first_uptime_checked:
          type: integer
        incidents:
          type: array
          items:
            $ref: '#/components/schemas/Incident'
        ongoing_incidents_count:
          type: integer
        resolved_incidents_count:
          type: integer
        action_required_tasks_count:
          type: integer
        non_urgent_tasks_count:
          type: integer
        completed_tasks_count:
          type: integer
        active_flags_count:
          type: integer
        removed_flags_count:
          type: integer
        mean_time_to_resolution_seconds:
          type: integer
    Incident:
      type: object
      properties:
        network_id:
          type: integer
        url:
          type: string
        network_tracking_domain_id:
          type: integer
        network_conversion_domain_id:
          type: integer
        identifier:
          type: string
        type:
          type: string
          description: Incident type (uptime / SSL / DNS / expiry category).
        status:
          type: string
          description: '`active` or `resolved`.'
        time_created:
          type: integer
        time_saved:
          type: integer
        time_last_observed:
          type: integer
        time_resolved:
          type: integer
          description: Unix seconds; `0` while the incident is active.
        relationship:
          type: object
          properties:
            factors:
              type: array
              description: Contributing signals for the incident.
              items:
                type: object
            tasks:
              type: array
              description: Remediation tasks linked to the incident.
              items:
                $ref: '#/components/schemas/Task'
    Task:
      type: object
      properties:
        network_id:
          type: integer
        url:
          type: string
        network_tracking_domain_id:
          type: integer
        network_conversion_domain_id:
          type: integer
        identifier:
          type: string
        type:
          type: string
          description: Task type (e.g. `renew_domain`).
        category:
          type: string
          description: Urgency category (e.g. `reactive`).
        status:
          type: string
          description: Task status (e.g. `to_do`).
        assignment:
          type: string
          description: Who the task is assigned to (e.g. `customer`).
        title:
          type: string
        description:
          type: string
        time_created:
          type: integer
        time_completed:
          type: integer
          description: Unix seconds; `0` while the task is open.
        relationship:
          type: object
          properties:
            incident_identifier:
              type: string
              description: The incident that generated the task.
  securitySchemes:
    API Key:
      type: apiKey
      in: header
      name: X-Eflow-Api-Key

````