> ## Documentation Index
> Fetch the complete documentation index at: https://conductorone-docs-terraform-v2-owner-resources.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Traffic Summary

> GetTrafficSummary returns app-scoped traffic counters and a time-bucketed
 outcome series for the Edges owned by app_id, over the same
 since/until window and Edge-resolution contract as ListTrafficEvents
 (empty/zero response when the app has no Edges or the audit reader isn't
 configured).



## OpenAPI

````yaml https://spec.speakeasy.com/conductor-one/conductorone/my-source-with-code-samples get /api/v1/apps/{app_id}/traffic-summary
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}/traffic-summary:
    get:
      tags:
        - Time Bandit Control Plane
      summary: Get Traffic Summary
      description: >-
        GetTrafficSummary returns app-scoped traffic counters and a
        time-bucketed
         outcome series for the Edges owned by app_id, over the same
         since/until window and Edge-resolution contract as ListTrafficEvents
         (empty/zero response when the app has no Edges or the audit reader isn't
         configured).
      operationId: c1.api.tbcontrolplane.v1.TBControlPlaneService.GetTrafficSummary
      parameters:
        - in: path
          name: app_id
          required: true
          schema:
            description: The appId field.
            type: string
        - in: query
          name: bucket
          schema:
            description: Defaults to TB_TIME_BUCKET_HOUR when unset.
            enum:
              - TB_TIME_BUCKET_UNSPECIFIED
              - TB_TIME_BUCKET_HOUR
              - TB_TIME_BUCKET_DAY
            type: string
            x-speakeasy-unknown-values: allow
        - in: query
          name: since
          schema:
            description: >-
              Same defaulting/bounding contract as
              ListTrafficEventsRequest.since --
               enforced by the handler, not this field's validation.
            format: int64
            type: string
        - in: query
          name: until
          schema:
            description: The until field.
            format: int64
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/c1.api.tbcontrolplane.v1.TBControlPlaneServiceGetTrafficSummaryResponse
          description: Successful response
components:
  schemas:
    c1.api.tbcontrolplane.v1.TBControlPlaneServiceGetTrafficSummaryResponse:
      description: The TBControlPlaneServiceGetTrafficSummaryResponse message.
      properties:
        allowedEvents:
          description: The allowedEvents field.
          format: uint64
          type: string
        deniedEvents:
          description: The deniedEvents field.
          format: uint64
          type: string
        distinctAgentCount:
          description: The distinctAgentCount field.
          format: uint64
          type: string
        distinctToolCount:
          description: The distinctToolCount field.
          format: uint64
          type: string
        series:
          description: The series field.
          items:
            $ref: >-
              #/components/schemas/c1.api.tbcontrolplane.v1.TBTrafficSummaryBucket
          type:
            - array
            - 'null'
        totalEvents:
          description: The totalEvents field.
          format: uint64
          type: string
        totalRequestBytes:
          description: The totalRequestBytes field.
          format: uint64
          type: string
        totalResponseBytes:
          description: The totalResponseBytes field.
          format: uint64
          type: string
        unspecifiedEvents:
          description: The unspecifiedEvents field.
          format: uint64
          type: string
      title: Tb Control Plane Service Get Traffic Summary Response
      type: object
      x-speakeasy-name-override: TBControlPlaneServiceGetTrafficSummaryResponse
    c1.api.tbcontrolplane.v1.TBTrafficSummaryBucket:
      description: TBTrafficSummaryBucket is one point in GetTrafficSummary's time series.
      properties:
        allowedEvents:
          description: The allowedEvents field.
          format: uint64
          type: string
        bucketStart:
          format: date-time
          type:
            - string
            - 'null'
        deniedEvents:
          description: The deniedEvents field.
          format: uint64
          type: string
        unspecifiedEvents:
          description: The unspecifiedEvents field.
          format: uint64
          type: string
      title: Tb Traffic Summary Bucket
      type: object
      x-speakeasy-name-override: TBTrafficSummaryBucket
  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

````