Provides access to UK police force data, including forces, senior officers, neighbourhoods, neighbourhood teams, events, and priorities. Endpoints are designed for easy chaining: use force and neighbourhood IDs from listing endpoints in detail endpoints.
/api/forcesgetForcesReturns a list of all UK police forces. Each force object contains the force's name and unique identifier (id). Use this endpoint to discover available force IDs, which are required for retrieving force details, senior officers, or neighbourhood data.
| Status | Description |
|---|---|
| 200 | A list of all UK police forces, each with its name and unique identifier (id). Use the 'id' value to call other endpoints that require a force ID. |
/api/forces/{id}getPoliceForceDetailsRetrieves detailed information for a single UK police force, specified by its unique identifier (id). The response includes the force's name, description, website URL, telephone, and engagement methods. To obtain a valid force ID, call the 'List all UK police forces' endpoint first.
| Name | In | Required | Description |
|---|---|---|---|
| id | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). Obtain this value from the 'List all UK police forces' endpoint. |
| Status | Description |
|---|---|
| 200 | Detailed information about the specified UK police force, including description, website, telephone, and engagement methods. |
/api/forces/{id}/peoplegetSeniorOfficersReturns a list of senior officers for a specific UK police force, identified by its unique id. Each officer object includes rank, name, and contact details. To obtain a valid force ID, first call the 'List all UK police forces' endpoint.
| Name | In | Required | Description |
|---|---|---|---|
| id | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). Obtain this value from the 'List all UK police forces' endpoint. |
| Status | Description |
|---|---|
| 200 | A list of senior officers for the specified police force, including their names, ranks, and contact details. |
/api/{force}/neighbourhoodsgetNeighbourhoodsReturns a list of all neighbourhood policing areas for a specific police force, identified by the force's unique id. Each neighbourhood object contains its name and unique identifier (neighbourhood_id). Use this endpoint to discover neighbourhood IDs for use in other endpoints. To obtain a valid force ID, call the 'List all UK police forces' endpoint first.
| Name | In | Required | Description |
|---|---|---|---|
| force | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). Obtain this value from the 'List all UK police forces' endpoint. |
| Status | Description |
|---|---|
| 200 | A list of neighbourhoods for the specified police force, each with its name and unique neighbourhood ID. Use the 'neighbourhood_id' value to call other endpoints that require a neighbourhood ID. |
/api/{force}/{neighbourhood_id}getNeighbourhoodDetailsRetrieves detailed information about a specific neighbourhood policing area, identified by the police force ID and neighbourhood ID. The response includes the neighbourhood's name, description, location, and contact details. To obtain valid IDs, first call 'List all UK police forces', then 'List neighbourhoods for a police force'.
| Name | In | Required | Description |
|---|---|---|---|
| force | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). |
| neighbourhood_id | path | Yes | The unique identifier for the neighbourhood. Obtain this value from the 'List neighbourhoods for a police force' endpoint. |
| Status | Description |
|---|---|
| 200 | Detailed information about the specified neighbourhood, including name, description, location, and contact details. |
/api/{force}/{neighbourhood_id}/eventsgetNeighbourhoodEventsReturns a list of upcoming public events and meetings for a specific neighbourhood policing team, identified by police force ID and neighbourhood ID. Each event includes title, description, date, and location. To obtain valid IDs, first call 'List all UK police forces', then 'List neighbourhoods for a police force'.
| Name | In | Required | Description |
|---|---|---|---|
| force | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). |
| neighbourhood_id | path | Yes | The unique identifier for the neighbourhood. Obtain this value from the 'List neighbourhoods for a police force' endpoint. |
| Status | Description |
|---|---|
| 200 | A list of upcoming events for the specified neighbourhood policing team, including title, description, date, and location. |
/api/{force}/{neighbourhood_id}/peoplegetNeighbourhoodTeamReturns a list of police officers and staff assigned to a specific neighbourhood policing team, identified by police force ID and neighbourhood ID. Each team member includes name, rank, and contact details. To obtain valid IDs, call 'List all UK police forces', then 'List neighbourhoods for a police force'.
| Name | In | Required | Description |
|---|---|---|---|
| force | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). |
| neighbourhood_id | path | Yes | The unique identifier for the neighbourhood. Obtain this value from the 'List neighbourhoods for a police force' endpoint. |
| Status | Description |
|---|---|
| 200 | A list of police officers and staff for the specified neighbourhood policing team, including names, ranks, and contact details. |
/api/{force}/{neighbourhood_id}/prioritiesgetNeighbourhoodPrioritiesReturns a list of current policing priorities for a specific neighbourhood, identified by police force ID and neighbourhood ID. Each priority includes a title, issue, and action taken. To obtain valid IDs, first call 'List all UK police forces', then 'List neighbourhoods for a police force'.
| Name | In | Required | Description |
|---|---|---|---|
| force | path | Yes | The unique identifier for the police force (e.g. 'leicestershire'). |
| neighbourhood_id | path | Yes | The unique identifier for the neighbourhood. Obtain this value from the 'List neighbourhoods for a police force' endpoint. |
| Status | Description |
|---|---|
| 200 | A list of current policing priorities for the specified neighbourhood, including title, issue, and action taken. |