> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-hunner-patch-1.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Egress Top Destinations

> Lists destinations ranked by egress request count for this Edge in the requested time window.



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/edges/{id}/egress/top-destinations
openapi: 3.1.0
info:
  description: The C1 API is a HTTP API for managing C1 resources.
  title: C1 API
  version: 0.1.0-alpha
servers:
  - description: The C1 API server for the current tenant.
    url: https://{tenantDomain}.conductor.one
    variables:
      tenantDomain:
        default: example
        description: The domain of the tenant to use for this request.
security:
  - bearerAuth: []
    oauth: []
paths:
  /api/v1/apps/{app_id}/edges/{id}/egress/top-destinations:
    get:
      tags:
        - Edge
      summary: List Egress Top Destinations
      description: >-
        Lists destinations ranked by egress request count for this Edge in the
        requested time window.
      operationId: c1.api.edge.v1.EdgeService.ListEgressTopDestinations
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: The appId field.
            type: string
        - in: path
          name: id
          required: true
          schema:
            description: The id field.
            type: string
        - in: query
          name: blocked_only
          schema:
            description: |-
              Restricts results to destinations with at least one denied row --
               equivalent to verdict = TB_TRAFFIC_OUTCOME_DENIED, offered separately
               so the UI can drive it from a standalone toggle.
            type: boolean
        - in: query
          name: host_contains
          schema:
            description: >-
              Case-insensitive substring match against dest_host. Empty means
              "every
               destination".
            type: string
        - in: query
          name: include_trend
          schema:
            description: >-
              When set, each returned TBTopDestination carries a call_count
              trend
               bucketed across trend_buckets equal-width buckets over [since, until).
            type: boolean
        - in: query
          name: limit
          schema:
            description: The limit field.
            format: int32
            type: integer
        - in: query
          name: offset
          schema:
            description: The offset field.
            format: int32
            type: integer
        - in: query
          name: principal_kind
          schema:
            description: >-
              Exact match against source_principal_kind. Empty means "every
              kind".
            type: string
        - in: query
          name: since
          schema:
            description: The since field.
            format: int64
            type: string
        - in: query
          name: trend_buckets
          schema:
            description: Bucket count for include_trend. 0 defaults to 14; capped at 60.
            format: int32
            type: integer
        - in: query
          name: until
          schema:
            description: The until field.
            format: int64
            type: string
        - in: query
          name: verdict
          schema:
            description: |-
              Restricts results to destinations with at least one row of this
               outcome. TB_TRAFFIC_OUTCOME_UNSPECIFIED applies no verdict filter.
            enum:
              - TB_TRAFFIC_OUTCOME_UNSPECIFIED
              - TB_TRAFFIC_OUTCOME_ALLOWED
              - TB_TRAFFIC_OUTCOME_DENIED
            type: string
            x-speakeasy-unknown-values: allow
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.edge.v1.EdgeServiceListEgressTopDestinationsResponse
          description: Successful response
components:
  schemas:
    c1.api.edge.v1.EdgeServiceListEgressTopDestinationsResponse:
      description: The EdgeServiceListEgressTopDestinationsResponse message.
      properties:
        destinations:
          description: |-
            Ordered by call_count descending, limited to limit. No pagination
             cursor -- this is a fixed top-N, not a full list.
          items:
            $ref: '#/components/schemas/c1.api.edge.v1.TBTopDestination'
          type:
            - array
            - 'null'
        distinctDestinationCount:
          description: >-
            uniqExact(dest_host) over the whole window, unaffected by any
            request
             filter -- lets the UI show "top N of distinct_destination_count
             destinations".
          format: int64
          type: string
        matchingDestinationCount:
          description: |-
            Count of destinations matching the request's filters (host_contains,
             verdict, principal_kind, blocked_only), independent of limit/offset --
             the paging total for the Dense table.
          format: int64
          type: string
      title: Edge Service List Egress Top Destinations Response
      type: object
      x-speakeasy-name-override: EdgeServiceListEgressTopDestinationsResponse
    c1.api.edge.v1.TBTopDestination:
      description: |-
        TBTopDestination is one dest_host group, excluding rows with an empty
         dest_host (non-egress or unresolved calls).
      properties:
        allowedCount:
          description: The allowedCount field.
          format: int64
          type: string
        callCount:
          description: The callCount field.
          format: int64
          type: string
        deniedCount:
          description: The deniedCount field.
          format: int64
          type: string
        destHost:
          description: The destHost field.
          type: string
        distinctAgentCount:
          description: The distinctAgentCount field.
          format: int64
          type: string
        requestBytes:
          description: The requestBytes field.
          format: int64
          type: string
        responseBytes:
          description: The responseBytes field.
          format: int64
          type: string
        trend:
          description: |-
            Zero-filled call_count series of length trend_buckets, oldest first.
             Only populated when the request set include_trend.
          items:
            format: int64
            type: string
          type:
            - array
            - 'null'
        unspecifiedCount:
          description: The unspecifiedCount field.
          format: int64
          type: string
      title: Tb Top Destination
      type: object
      x-speakeasy-name-override: TBTopDestination
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http
    oauth:
      description: >-
        This API uses OAuth2 with the Client Credential flow.

        Client Credentials must be sent in the BODY, not the headers.

        For an example of how to implement this, refer to the
        [c1TokenSource.Token()](https://github.com/ConductorOne/conductorone-sdk-go/blob/3375fe7c0126d17e7ec4e711693dee7b791023aa/token_source.go#L101-L187)
        function.
      flows:
        clientCredentials:
          scopes: {}
          tokenUrl: /auth/v1/token
      type: oauth2

````