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

# Get Dashboard Connection Statistics

> Returns the Connections section of the Dashboard for a period: connection requests sent, the requests sent and the requests accepted on each day (each counted on its own day), and the acceptance rate. The period is `startDate`–`endDate`, both calendar days included, in `timezone`: 1 to 31 days, and `endDate` is not later than today in that timezone. A period outside these rules or an unknown timezone is refused with 400. To get the same numbers as the Extrovert Dashboard, pass the `timezone` of the user's profile (the `timezone` field of the user in the Team Members list). Comparison values are against the preceding range of the same number of days. The acceptance rate is All time: it covers every request ever sent and does not depend on the period. Both id filters are optional: an omitted or empty filter does not narrow that dimension, and without filters every campaign of the caller's scope is counted. `campaignsIds` come from the Campaign list and `ownersIds` from the Team Members list; when both are given they narrow the scope together (AND), and an id outside the caller's scope is refused with 403.



## OpenAPI

````yaml https://api.goextrovert.com/client/v2/docs-json get /client/v2/dashboard/connections
openapi: 3.1.0
info:
  title: Extrovert Client API
  description: >-
    Public API for Extrovert platform integration. Use your API key for
    authentication.
  version: '1.0'
  contact: {}
servers:
  - url: https://api.goextrovert.com/
    description: API Server
security: []
tags: []
paths:
  /client/v2/dashboard/connections:
    get:
      tags:
        - Dashboard
      summary: Get Dashboard Connection Statistics
      description: >-
        Returns the Connections section of the Dashboard for a period:
        connection requests sent, the requests sent and the requests accepted on
        each day (each counted on its own day), and the acceptance rate. The
        period is `startDate`–`endDate`, both calendar days included, in
        `timezone`: 1 to 31 days, and `endDate` is not later than today in that
        timezone. A period outside these rules or an unknown timezone is refused
        with 400. To get the same numbers as the Extrovert Dashboard, pass the
        `timezone` of the user's profile (the `timezone` field of the user in
        the Team Members list). Comparison values are against the preceding
        range of the same number of days. The acceptance rate is All time: it
        covers every request ever sent and does not depend on the period. Both
        id filters are optional: an omitted or empty filter does not narrow that
        dimension, and without filters every campaign of the caller's scope is
        counted. `campaignsIds` come from the Campaign list and `ownersIds` from
        the Team Members list; when both are given they narrow the scope
        together (AND), and an id outside the caller's scope is refused with
        403.
      operationId: DashboardStatisticsClientApiController_getConnections
      parameters:
        - description: >-
            Optional campaign-owner user IDs in the accessible workspace scope.
            Omit or pass `[]` for no owner filter; combined with `campaignsIds`
            using AND.
          required: false
          name: ownersIds
          in: query
          schema:
            type: array
        - description: >-
            Optional campaign IDs in the accessible workspace scope. Omit or
            pass `[]` for no campaign filter; combined with `ownersIds` using
            AND.
          required: false
          name: campaignsIds
          in: query
          schema:
            type: array
        - description: First calendar day of the period, included, `YYYY-MM-DD`.
          examples:
            example1:
              value: '2026-09-12'
          required: true
          name: startDate
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - description: >-
            Last calendar day of the period, included, `YYYY-MM-DD`. Not later
            than today in `timezone`.
          examples:
            example1:
              value: '2026-10-11'
          required: true
          name: endDate
          in: query
          schema:
            pattern: ^\d{4}-\d{2}-\d{2}$
            type: string
        - description: >-
            Required IANA timezone the calendar days are taken in. Use the
            user's profile `timezone` to match the Dashboard.
          examples:
            example1:
              value: Europe/Paris
            example2:
              value: America/New_York
          required: true
          name: timezone
          in: query
          schema:
            type: string
            minLength: 1
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetConnectionsResponseDto'
        '401':
          description: Invalid or missing API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClientApiErrorResponseDto'
      security:
        - api-key: []
components:
  schemas:
    GetConnectionsResponseDto:
      type: object
      properties:
        status:
          type: string
          const: success
          description: Response status
        data:
          type: object
          properties:
            period:
              type: object
              properties:
                startDate:
                  type: string
                  description: First calendar day of the period, included, `YYYY-MM-DD`.
                endDate:
                  type: string
                  description: Last calendar day of the period, included, `YYYY-MM-DD`.
                timezone:
                  type: string
                  description: IANA timezone the period was computed in.
                daysCount:
                  type: integer
                  minimum: -9007199254740991
                  maximum: 9007199254740991
                  description: Number of calendar days in the period.
              required:
                - startDate
                - endDate
                - timezone
                - daysCount
              description: The validated period the values were computed for.
            connectionRequestsSent:
              description: >-
                Connection requests sent in the period, with the comparison to
                the preceding range.
              type: object
              properties:
                currentIntervalValue:
                  type: number
                  description: Value for the period.
                changePercentVsPreviousPeriod:
                  type: number
                  description: >-
                    Percent change of `currentIntervalValue` against the
                    preceding range of the same number of days (e.g. `-50` is
                    half, `100` is double) — a change, not the preceding value
                    itself. `0` both when nothing changed and when the preceding
                    range had nothing.
              required:
                - currentIntervalValue
                - changePercentVsPreviousPeriod
            dailyStatisticsList:
              type: array
              items:
                type: object
                properties:
                  date:
                    type: string
                    description: Calendar day, `YYYY-MM-DD`.
                  sentCount:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: Connection requests sent on this day.
                  acceptedCount:
                    type: integer
                    minimum: -9007199254740991
                    maximum: 9007199254740991
                    description: >-
                      Connection requests accepted on this day, counted by the
                      day of acceptance whatever day the request was sent; not a
                      subset of `sentCount`.
                required:
                  - date
                  - sentCount
                  - acceptedCount
              description: >-
                One item per calendar day of the period, days without activity
                included.
            acceptanceRate:
              description: 'All time: connection acceptance rate, not bound to the period.'
              type: object
              properties:
                totalRate:
                  description: Rate over all requests.
                  type: object
                  properties:
                    sentCount:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                      description: Connection requests sent, all time.
                    acceptedCount:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                      description: Of those, requests accepted, all time.
                    acceptanceRate:
                      type: number
                      description: >-
                        `acceptedCount / sentCount` in percent (0–100), all
                        time.
                  required:
                    - sentCount
                    - acceptedCount
                    - acceptanceRate
                perReasonRate:
                  type: array
                  items:
                    type: object
                    properties:
                      reason:
                        type: string
                        enum:
                          - DIRECT_COMMENTS
                          - INDIRECT_COMMENTS
                          - NO_COMMENTS
                        description: Rule the requests were sent under.
                      rate:
                        type: object
                        properties:
                          sentCount:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                            description: Connection requests sent, all time.
                          acceptedCount:
                            type: integer
                            minimum: -9007199254740991
                            maximum: 9007199254740991
                            description: Of those, requests accepted, all time.
                          acceptanceRate:
                            type: number
                            description: >-
                              `acceptedCount / sentCount` in percent (0–100),
                              all time.
                        required:
                          - sentCount
                          - acceptedCount
                          - acceptanceRate
                    required:
                      - reason
                  description: Rate per rule the requests were sent under.
              required:
                - perReasonRate
          description: Connections section for the period
          required:
            - dailyStatisticsList
        message:
          type: string
          description: Success message
          examples:
            - Operation completed successfully
      required:
        - status
        - data
        - message
    ClientApiErrorResponseDto:
      type: object
      properties:
        status:
          type: string
          description: Response status
          example: error
          enum:
            - error
        data:
          type: object
          description: Response data
          example: null
          nullable: true
        message:
          type: string
          description: Error message
          example: An error occurred while processing the request
      required:
        - status
        - data
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key for authentication

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.