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

# Retrieve general conversation statistics

Returns comprehensive conversation metrics broken down by date, channel, source, and agent. Data can be filtered by date range, tag, and aggregated by custom intervals (hours, days, weeks, months, years).


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /reporting/general
openapi: 3.0.3
info:
  title: Fernand API Documentation
  version: '3.0'
  description: This is the documentation for the [Fernand](https://getfernand.com) API.
  termsOfService: https://getfernand.com/terms
  contact:
    name: Fernand Support
    url: https://getfernand.com
    email: support@getfernand.com
  x-logo:
    url: https://app.getfernand.com/images/favicon/icon_128.png
servers:
  - url: https://api.getfernand.com
    description: ''
    x-last-modified: 1764750693905
security:
  - apiKeyHeader: []
externalDocs:
  description: You can access our documentation online by visiting https://api.fernand.help
  url: https://api.fernand.help
paths:
  /reporting/general:
    get:
      tags:
        - Reporting
      summary: Retrieve general conversation statistics
      description: >-
        Returns comprehensive conversation metrics broken down by date, channel,
        source, and agent. Data can be filtered by date range, tag, and
        aggregated by custom intervals (hours, days, weeks, months, years).
      operationId: getGeneralStatistics
      parameters:
        - name: start
          in: query
          required: true
          schema:
            type: string
            format: date
          description: Start date for the statistics range in YYYY-MM-DD format.
          example: '2026-01-01'
        - name: end
          in: query
          required: true
          schema:
            type: string
            format: date
          description: End date for the statistics range in YYYY-MM-DD format.
          example: '2026-01-31'
        - name: interval
          in: query
          required: false
          schema:
            type: string
            enum:
              - hours
              - days
              - weeks
              - months
              - years
          description: >-
            Granularity of the time-based aggregation. If not specified,
            automatically determined based on date range (<=3 days=hours, <=31
            days=days, <=90 days=days, >90 days=months).
          example: days
        - name: tag
          in: query
          required: false
          schema:
            type: string
          description: Filter statistics to only conversations with this tag slug.
          example: support
      responses:
        '200':
          description: Statistics retrieved successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  inbox:
                    type: object
                    description: >-
                      Number of conversations created, grouped by date with
                      breakdowns by channel, source, and assigned agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation (e.g., EMAIL, CHAT).
                            enum:
                              - EMAIL
                              - CHAT
                            example: EMAIL
                          agent_id:
                            type: integer
                            nullable: true
                            description: ID of the agent assigned to the conversation.
                            example: 456
                          value:
                            type: integer
                            description: Count of conversations matching these dimensions.
                            example: 42
                  assigned:
                    type: object
                    description: >-
                      Number of conversations assigned to an agent, grouped by
                      date with breakdowns by channel, source, and agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation.
                            example: CHAT
                          agent_id:
                            type: integer
                            description: ID of the assigned agent.
                            example: 456
                          value:
                            type: integer
                            description: Count of conversations assigned.
                            example: 35
                  closed:
                    type: object
                    description: >-
                      Number of conversations closed, grouped by date with
                      breakdowns by channel, source, and closing agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation.
                            example: EMAIL
                          agent_id:
                            type: integer
                            description: ID of the agent who closed the conversation.
                            example: 456
                          value:
                            type: integer
                            description: Count of conversations closed.
                            example: 28
                  responded:
                    type: object
                    description: >-
                      Number of conversations that received first response,
                      grouped by date with breakdowns by channel, source, and
                      responding agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation.
                            example: TWITTER
                          agent_id:
                            type: integer
                            description: ID of the agent who first responded.
                            example: 456
                          value:
                            type: integer
                            description: Count of conversations responded to.
                            example: 40
                  resolved:
                    type: object
                    description: >-
                      Number of conversations resolved, grouped by date with
                      breakdowns by channel, source, and resolving agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation.
                            example: EMAIL
                          agent_id:
                            type: integer
                            description: ID of the agent who resolved the conversation.
                            example: 456
                          value:
                            type: integer
                            description: Count of conversations resolved.
                            example: 30
                  ttfr:
                    type: object
                    description: >-
                      Average time to first response in seconds, grouped by date
                      with breakdowns by channel, source, and responding agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation.
                            example: CHAT
                          agent_id:
                            type: integer
                            description: ID of the responding agent.
                            example: 456
                          value:
                            type: number
                            format: float
                            description: Average time to first response in seconds.
                            example: 1847.5
                  ttr:
                    type: object
                    description: >-
                      Average time to resolution in seconds, grouped by date
                      with breakdowns by channel, source, and resolving agent.
                    additionalProperties:
                      type: array
                      items:
                        type: object
                        properties:
                          channel_id:
                            type: integer
                            nullable: true
                            description: ID of the channel.
                            example: 123
                          source:
                            type: string
                            description: Source of the conversation.
                            example: EMAIL
                          agent_id:
                            type: integer
                            description: ID of the resolving agent.
                            example: 456
                          value:
                            type: number
                            format: float
                            description: Average time to resolution in seconds.
                            example: 86400
        '400':
          description: Invalid input parameters or date validation error.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message describing the validation failure.
                    example: Invalid date for 'start'
        '403':
          description: Insufficient permissions to access reporting data.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message.
                    example: Access denied
components:
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      description: >-
        Authenticate your account by including your secret key in API requests.

        You can manage your API keys in the
        [Dashboard](https://app.getfernand.com/).


        Authentication to the API is performed by using the HTTP Header
        X-API-Key.
      name: X-API-Key
      in: header
      x-last-modified: 1764750344730

````