> ## Documentation Index > Fetch the complete documentation index at: https://docs.costgraph.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get connection > Returns one network edge -- both endpoints resolved to services, edge metadata, and counters aggregated over the range. Each service carries the whole network endpoint record plus its resolved inventory name, the same shape the service map returns. A connection with no traffic in the range returns zeroed counters ## OpenAPI ````yaml /api-reference/costgraph/openapi.json get /api/v1/tenant/service-map/connections/{id} openapi: 3.0.0 info: description: Read and manage your CostGraph organization, spend, alerts, and settings. title: CostGraph API contact: {} version: '1.0' servers: - url: https://api.costgraph.ai security: [] tags: - name: ai x-group: AI - name: ai-serving x-group: AI serving - name: anomalies x-group: Anomalies - name: auth x-group: Auth - name: billing x-group: Billing - name: billing-export x-group: Billing export - name: budgets x-group: Budgets - name: ci x-group: CI - name: compute-recommendations x-group: Compute recommendations - name: config x-group: Config - name: cost x-group: Cost - name: gpus x-group: GPUs - name: graphai x-group: Graph AI - name: infracost x-group: Infracost - name: integrations x-group: Integrations - name: invitations x-group: Invitations - name: kubernetes-clusters x-group: Kubernetes clusters - name: marketplace x-group: Marketplace - name: network-requests x-group: Network requests - name: notifications x-group: Notifications - name: oauth x-group: OAuth - name: oauth-clients x-group: OAuth clients - name: opencost x-group: OpenCost - name: organization x-group: Audit log - name: organizations x-group: Organizations - name: placement-alternatives x-group: Placement alternatives - name: reports x-group: Reports - name: service-map x-group: Service map - name: settings x-group: Settings - name: sso x-group: Single sign-on - name: tenants x-group: Tenants - name: user x-group: Users - name: virtual-machines x-group: Virtual machines - name: virtual-tags x-group: Virtual tags - name: workflows x-group: Workflows paths: /api/v1/tenant/service-map/connections/{id}: get: tags: - service-map summary: Get connection description: >- Returns one network edge -- both endpoints resolved to services, edge metadata, and counters aggregated over the range. Each service carries the whole network endpoint record plus its resolved inventory name, the same shape the service map returns. A connection with no traffic in the range returns zeroed counters parameters: - description: Tenant ID name: X-CostGraph-Tenant-ID in: header required: true schema: type: string - description: Connection ID (network report ID) name: id in: path required: true schema: type: string - description: Range start timestamp in RFC3339 format name: start in: query required: true schema: type: string - description: Range end timestamp in RFC3339 format name: end in: query required: true schema: type: string responses: '200': description: OK content: application/json: schema: allOf: - $ref: '#/components/schemas/responses.SuccessResponse' - type: object properties: data: $ref: '#/components/schemas/servicemap.Connection' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/responses.ErrorResponse' security: - BearerAuth: [] components: schemas: responses.SuccessResponse: type: object required: - message - status properties: data: {} message: type: string example: some message status: type: string example: success servicemap.Connection: type: object properties: client: $ref: '#/components/schemas/servicemap.Service' counters: $ref: '#/components/schemas/schema.NetworkReportsHourlyRow' id: type: string metadata: $ref: '#/components/schemas/schema.NetworkReportsRow' server: $ref: '#/components/schemas/servicemap.Service' responses.ErrorResponse: type: object required: - message - status properties: message: type: string example: some message status: type: string example: error servicemap.Service: type: object properties: cluster: description: Kubernetes cluster the endpoint belongs to; empty off-cluster. type: string created_at: type: string endpoint_key: type: string group: type: string id: type: string kind: description: Derived from endpoint_key. type: string labels: type: object additionalProperties: type: string name: type: string parent_kind: type: string parent_name: description: >- The resource owning this workload, for a topology view. Empty when the workload is already the root, or the endpoint is not a workload. type: string resolution_source: type: string superseded_by_endpoint_id: type: string tags: type: object tenant_id: type: string updated_at: type: string schema.NetworkReportsHourlyRow: type: object properties: bucket_start: type: string bytes_client_to_server: type: number bytes_server_to_client: type: number connections_active_max: type: integer connections_closed: type: integer connections_failed: type: integer connections_opened: type: integer connections_refused: type: integer connections_reset: type: integer created_at: type: string id: type: string network_report_id: type: string observed_from: type: string observed_seconds: type: number packets_client_to_server: type: number packets_server_to_client: type: number tenant_id: type: string updated_at: type: string schema.NetworkReportsRow: type: object properties: attributed_cost_monthly: type: number charged_direction: type: string client_az: type: string client_endpoint_id: type: string cost_mechanism: type: string created_at: type: string id: type: string locality: type: string locality_source: type: string nat_translated: type: boolean pricing_source: type: string proto: type: string server_az: type: string server_endpoint_id: type: string server_port: type: number service_vip_observed: type: boolean tags: type: object tenant_id: type: string updated_at: type: string securitySchemes: BearerAuth: description: Enter "Bearer {token}" type: apiKey name: Authorization in: header ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.