> ## 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 articles statistics for the Knowledge Base

Returns the top 20 articles for the specified date range. Results can be ordered by various metrics to identify high-performing or problematic articles.


## OpenAPI

````yaml https://api.getfernand.com/openapi.json get /reporting/knowledge/articles
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/knowledge/articles:
    get:
      tags:
        - Knowledge Base Reporting
      summary: Retrieve articles statistics for the Knowledge Base
      description: >-
        Returns the top 20 articles for the specified date range. Results can be
        ordered by various metrics to identify high-performing or problematic
        articles.
      operationId: getKnowledgeArticles
      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: order_by
          in: query
          required: false
          schema:
            type: string
            enum:
              - last_updated
              - total_views
              - disappointed
              - neutral
              - happy
            default: total_views
          description: Field to order results by.
          example: total_views
        - name: order_way
          in: query
          required: false
          schema:
            type: string
            enum:
              - ASC
              - DESC
            default: DESC
          description: Sort direction (ascending or descending).
          example: DESC
      responses:
        '200':
          description: Articles retrieved successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      description: Unique identifier of the article.
                      example: 789
                    title:
                      type: string
                      description: Title of the article.
                      example: How to reset your password
                    link:
                      type: string
                      format: uri
                      description: Full URL to view the article.
                      example: >-
                        https://help.piedpiper.com/articles/789-how-to-reset-your-password
                    category_id:
                      type: integer
                      nullable: true
                      description: ID of the collection/category this article belongs to.
                      example: 12
                    last_updated:
                      type: string
                      format: date-time
                      description: ISO 8601 timestamp of when the article was last updated.
                      example: '2026-01-15T14:30:00Z'
                    views:
                      type: integer
                      description: Total number of views during the specified date range.
                      example: 1847
                    score:
                      type: object
                      description: Breakdown of user satisfaction ratings for this article.
                      properties:
                        disappointed:
                          type: integer
                          description: Number of negative ratings (score = -1).
                          example: 5
                        neutral:
                          type: integer
                          description: Number of neutral ratings (score = 0).
                          example: 12
                        happy:
                          type: integer
                          description: Number of positive ratings (score = 1).
                          example: 48
        '400':
          description: >-
            Invalid input parameters, date validation error, or invalid ordering
            field.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error message describing the validation failure.
                    example: >-
                      Invalid ordering field. Only 'last_updated',
                      'total_views', 'disappointed', 'neutral' or 'happy' are
                      accepted
        '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

````