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

# Count connections

> Returns the number of connections associated with the authenticated user, grouped by connection type, together with the connection limits that apply to the user. Forward-only connections are excluded from the counts.



## OpenAPI

````yaml /openapi/source/external/connections/connections.json get /connections/count
openapi: 3.1.0
info:
  version: 2.0.0
  x-latency-category: responsive
  x-endpoint-cost: light
  title: Telnyx API
  description: SIP trunking, SMS, MMS, Call Control and Telephony Data Services.
  contact:
    email: support@telnyx.com
servers:
  - url: https://api.telnyx.com/v2
    description: Version 2.0.0 of the Telnyx API
security:
  - bearerAuth: []
tags:
  - name: Connections
    description: Connections operations
  - name: IP Connections
    description: IP connection operations
  - name: Credential Connections
    description: Credential connection operations
  - name: UAC Connections
    description: UAC connection operations
  - name: IPs
    description: IP operations
  - name: FQDN Connections
    description: FQDN connection operations
  - name: FQDNs
    description: FQDN operations
paths:
  /connections/count:
    get:
      tags:
        - Connections
      summary: Count connections
      description: >-
        Returns the number of connections associated with the authenticated
        user, grouped by connection type, together with the connection limits
        that apply to the user. Forward-only connections are excluded from the
        counts.
      operationId: CountConnections
      responses:
        '200':
          description: Successful response with connection counts and limits.
          content:
            application/json:
              schema:
                type: object
                title: Connections Count Response
                required:
                  - data
                properties:
                  data:
                    $ref: '#/components/schemas/ConnectionsCount'
              example:
                data:
                  record_type: connections_count
                  counts:
                    ip_connections: 12
                    credential_connections: 5
                    uac_connections: 0
                    fqdn_connections: 3
                    call_control_applications: 2
                    texml_applications: 1
                    third_party_provider_connections: 0
                    external_connections: 1
                    fax_connections: 0
                    mobile_voice_connections: 0
                    microsoft_teams_sbc_connections: 0
                    zoom_sbc_connections: 0
                    operator_connect_connections: 0
                  limits:
                    global_limit: 10000
        '401':
          $ref: '#/components/responses/UnauthenticatedResponse'
components:
  schemas:
    ConnectionsCount:
      title: Connections Count
      type: object
      required:
        - record_type
        - counts
        - limits
      properties:
        record_type:
          type: string
          description: Identifies the type of the resource.
          example: connections_count
        counts:
          type: object
          description: >-
            Counts of the authenticated user's connections, grouped by
            connection type. Forward-only connections are excluded.
          required:
            - ip_connections
            - credential_connections
            - uac_connections
            - fqdn_connections
            - call_control_applications
            - texml_applications
            - third_party_provider_connections
            - external_connections
            - fax_connections
            - mobile_voice_connections
            - microsoft_teams_sbc_connections
            - zoom_sbc_connections
            - operator_connect_connections
          properties:
            ip_connections:
              type: integer
              description: Number of IP connections.
            credential_connections:
              type: integer
              description: Number of credential connections.
            uac_connections:
              type: integer
              description: Number of UAC connections.
            fqdn_connections:
              type: integer
              description: Number of FQDN connections.
            call_control_applications:
              type: integer
              description: Number of Call Control applications.
            texml_applications:
              type: integer
              description: Number of TeXML applications.
            third_party_provider_connections:
              type: integer
              description: Number of third-party provider connections.
            external_connections:
              type: integer
              description: Number of external connections.
            fax_connections:
              type: integer
              description: Number of Fax applications.
            mobile_voice_connections:
              type: integer
              description: Number of mobile voice (IMS) connections.
            microsoft_teams_sbc_connections:
              type: integer
              description: Number of Microsoft Teams SBC (direct routing) connections.
            zoom_sbc_connections:
              type: integer
              description: Number of Zoom SBC connections.
            operator_connect_connections:
              type: integer
              description: Number of Microsoft Operator Connect connections.
        limits:
          type: object
          description: >-
            Connection limits that apply to the user. Contains a single
            global_limit when a global connection limit applies, or per-type
            limits (standard_limit, texml_limit and uac_limit) when the user has
            per-type connection count capabilities.
          oneOf:
            - title: Global Connection Limit
              type: object
              additionalProperties: false
              required:
                - global_limit
              properties:
                global_limit:
                  type: integer
                  description: >-
                    Maximum total number of connections allowed, when a global
                    limit applies.
                  example: 10000
            - title: Per-type Connection Limits
              type: object
              additionalProperties: false
              required:
                - standard_limit
                - texml_limit
                - uac_limit
              properties:
                standard_limit:
                  type: integer
                  description: >-
                    Maximum number of standard connections allowed, when
                    per-type limits apply.
                texml_limit:
                  type: integer
                  description: >-
                    Maximum number of TeXML applications allowed, when per-type
                    limits apply.
                uac_limit:
                  type: integer
                  description: >-
                    Maximum number of UAC connections allowed, when per-type
                    limits apply.
    ErrorResponse:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              code:
                type: string
              detail:
                type: string
              meta:
                type: object
                properties:
                  url:
                    type: string
                    format: uri
              title:
                type: string
              source:
                type: object
                properties:
                  pointer:
                    type: string
  responses:
    UnauthenticatedResponse:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            Authentication Failed:
              value:
                errors:
                  - code: '10009'
                    title: Authentication failed
                    detail: Could not understand the provided credentials.
                    meta:
                      url: https://developers.telnyx.com/docs/overview/errors/10009
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````