> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aegister.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Cloud Defender traffic summary

> Aggregated blocked-traffic figures for one protected domain over a window: totals, the busiest sources, the blocking layer and the daily series.
Blocked requests recorded before the sending address was captured are counted in the total but reported separately, because they cannot be attributed to a source.



## OpenAPI

````yaml get /api/v1/cloud-defender/{id}/traffic/summary
openapi: 3.1.0
info:
  title: Aegister API
  version: 1.1.0
servers: []
security: []
paths:
  /api/v1/cloud-defender/{id}/traffic/summary:
    get:
      tags:
        - cloud-defender
      summary: Get Cloud Defender blocked-threat summary
      description: >-
        Aggregated blocked-threat metrics for a Cloud Defender domain you can
        view.
      operationId: cloud_defender_traffic_summary_retrieve
      parameters:
        - in: query
          name: days
          schema:
            type: number
            default: 7
          description: Window in days (1-365).
        - in: path
          name: id
          schema:
            type: integer
          required: true
        - in: query
          name: top
          schema:
            type: number
            default: 20
          description: How many top source IPs to return and enrich (1-100).
      responses:
        '200':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 0
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
                  data:
                    type: object
          description: ''
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - - 9153
          description: ''
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: integer
                    description: |-
                      Any value different from 0 indicates an error.  
                      More details can be found in `messages`.
                    minimum: 0
                    maximum: 0
                    examples:
                      - 1
                  messages:
                    type: array
                    description: >-
                      If `error` is `1`, contains zero or more details on the
                      error.
                    examples:
                      - []
          description: ''
      security:
        - ApiKeyAuth: []
        - ApiKeyQueryParam: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Aegister-Token
    ApiKeyQueryParam:
      type: apiKey
      in: query
      name: X-Aegister-Token

````