************************************
``GET`` Per-track Statistics
************************************

This API retrieves stage-wise and overall applicant statistics for a specific track.

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

.. code-block::
    
    GET /tracks/<track_id>/stats

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

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

+-------------------+------------------+---------------------------------------------------------------------------------------------------+
| Parameter         | Type             | Description                                                                                       |
+===================+==================+===================================================================================================+
| track_id          | *integer*        | ID of the track for which statistics are to be fetched.                                           |
+-------------------+------------------+---------------------------------------------------------------------------------------------------+
| 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 per-stage counts and track totals.

.. code-block:: JSON

    {
        "track_id": "integer",
        "title": "string",
        "active": "boolean",
        "created_at": "string",
        "updated_at": "string",
        "totals": {
            "applicants": "integer",
            "in_pipeline": "integer",
            "hired": "integer",
            "rejected": "integer",
            "by_status": { }
        },
        "stages": [
            {
                "stage_id": "string",
                "name": "string",
                "type": "string",
                "count": "integer",
                "status_counts": { }
            }
        ],
        "applicant_timestamps": {
            "first_added": "string",
            "last_added": "string",
            "first_updated": "string",
            "last_updated": "string"
        },
        "filters_applied": {
            "timeframe_field": "string",
            "from_date": "string",
            "to_date": "string"
        }
    }