Skip to content

Accident Stats Handler

Handler to interact with the accident stats API.

AccidentStatsHandler

Bases: base.TFLHandler

Handler to interact with the accident stats API.

API reference

As it stands, the API does not include data between 2020 and 2023.

Example 
from tfl import clients


async with clients.TFLClient(auth=clients.Auth(key="<your-tfl-api-key>")) as client:
    response = await AccidentStatsHandler(client).get_accident_stats()

print(response.json())
Source code in tfl/clients/handlers/_accident_stats_handler.py 
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
class AccidentStatsHandler(base.TFLHandler):
    """Handler to interact with the accident stats API.

    [API reference](https://api-portal.tfl.gov.uk/api-details#api=AccidentStats&operation=AccidentStats_Get)

    As it stands, the API does not include data between 2020 and 2023.

    Example:
        ```python
        from tfl import clients


        async with clients.TFLClient(auth=clients.Auth(key="<your-tfl-api-key>")) as client:
            response = await AccidentStatsHandler(client).get_accident_stats()

        print(response.json())
        ```
    """

    async def get_accident_stats(self, year: int) -> httpx.Response:
        """Gets all accident details for accidents occurring in the specified year.

        Returns:
            The response from the API.
        """
        return await self.client.get(url=f"/AccidentStats/{year}")

get_accident_stats(year) async

Gets all accident details for accidents occurring in the specified year.

Returns:

Type Description
httpx.Response

The response from the API.
Source code in tfl/clients/handlers/_accident_stats_handler.py 
29
30
31
32
33
34
35
async def get_accident_stats(self, year: int) -> httpx.Response:
    """Gets all accident details for accidents occurring in the specified year.

    Returns:
        The response from the API.
    """
    return await self.client.get(url=f"/AccidentStats/{year}")