************************************************
``GET`` Account-wide Track Statistics
************************************************

This API retrieves aggregated track and applicant statistics for your account.

Request URL
=============

.. code-block::
    
    GET /tracks/stats

.. warning::
    
    Make sure to add your API key in Header of the request

Parameters
===========

+-------------------+------------------+---------------------------------------------------------------------------------------------------+
| Parameter         | Type             | Description                                                                                       |
+===================+==================+===================================================================================================+
| from_date         | *date*           | Inclusive start date in ``YYYY-MM-DD`` format.                                                    |
+-------------------+------------------+---------------------------------------------------------------------------------------------------+
| to_date           | *date*           | Inclusive end date in ``YYYY-MM-DD`` format.                                                      |
+-------------------+------------------+---------------------------------------------------------------------------------------------------+
| timeframe_field   | *string*         | Date field used for range filters. Allowed values: ``date_added``, ``last_updated_at``.           |
+-------------------+------------------+---------------------------------------------------------------------------------------------------+

Response
==========

- A JSON response containing account-level totals and stage-wise distribution.

.. code-block:: JSON

    {
        "totals": {
            "tracks": "integer",
            "active_tracks": "integer",
            "inactive_tracks": "integer",
            "applicants": "integer",
            "in_pipeline": "integer",
            "hired": "integer",
            "rejected": "integer",
            "by_status": { }
        },
        "applicants_by_stage_type": { },
        "top_tracks_by_applicants": [
            {
                "track_id": "integer",
                "title": "string",
                "applicant_count": "integer"
            }
        ],
        "recently_updated_tracks": [
            {
                "track_id": "integer",
                "title": "string",
                "updated_at": "string"
            }
        ],
        "filters_applied": {
            "timeframe_field": "string",
            "from_date": "string",
            "to_date": "string"
        }
    }