Filters

Filters define which stations are included in the Tile Service response. While all filters perform exclusion, EVSE-level filters also transform the station’s data fields to ensure the output is contextually relevant to the specific search criteria.

Filters are categorized into two types based on their impact on the response payload:

Station-level Filters (Exclusion Only)
- Evaluates global station attributes. Stations that do not meet the criteria are removed. Data fields for the remaining stations remain unchanged.
EVSE-level Filters (Exclusion + Transformation)
- Evaluates specific evse properties. Stations without matching hardware are excluded. For the remaining stations, the dynamic properties - evse_status_* and connector_maximum_power — are recalculated to reflect only the hardware satisfying the filter.

Implementation

Filter parameters can be appended to the request URL as query strings to any of the Tile Service endpoints (MVT or JSON or Count). When no filters are applied, the API returns the full set of available charging stations in their raw, non-transformed state.

Filters / URL Example

          https://api.chargetrip.io/v2/station/..../?{filter_1}&{filter_2}&{filter_n}

Parameters

An overview of possible filter parameters can be found below.

Station-level filters

Filters that evaluate the station's global attributes. These filters are exclusion-only: exclude non-matching stations but never modify the returned data fields.

amenities

Filter to include only stations that provide the specified amenities near or at the station.

Show query example

          ?amenities[]=HOTEL /* Default value */// All amenities /* Accepted values */// Hotel// Shopping// Bathroom// Supermarket// Playground// Pharmacy// Museum// Coffee// Park// Restaurant

preferred_operators

Filter to include only stations operated by pre-defined preferred operators. Preferred operators can be set in project settings within the dashboard.

Show query example

          ?preferred_operators=true /* Default value */// false

hide_excluded_operators

Filter to exclude stations operated by excluded operators. Excluded operators can be set in project settings within the dashboard.

Show query example

          ?hide_excluded_operators=true /* Default value */// false

operator_ids

Filter that configures the operators that will be included in the tiles.

Show query example

          ?operator_ids[]=631834841e604d2273ffb2b5&operator_ids[]=64e6979d49ed0ae2316ec052 /* Default value */// All operators

truck_dedicated

Filter to include only stations dedicated or primarily intended for truck charging. Only applicable if the Eco-Movement station database is used; otherwise, it is ignored.

Show query example

          ?truck_dedicated=true /* Default value */// False

vehicle_types

Filter to include only stations supporting the specified OCPI Vehicle Types. Only applicable if the Eco-Movement station database is used; otherwise, it is ignored.

Show query example

          ?vehicle_types[]=VAN&vehicle_types[]=RIGID /* Default value */// All vehicle types /* Accepted values */// Van// Rigid// Truck_with_trailer

EVSE-Level Filters

Filters that evaluate the station’s specific charging capabilities. These filters perform exclusion and transformation: non-matching stations are excluded, and matching stations have their dynamic fields recalculated.

minimum_power

Filter to include only stations where at least one connector meets or exceeds the specified power value (in kW).

Show query example

          ?minimum_power=50 /* Default value */// All minimum powers /* Accepted values */// Integer greater than 0.

maximum_power

Filter to include only stations where the maximum charging power of any connector does not exceed the specified power value (in kW).

Show query example

          ?maximum_power=150 /* Default value */// All maximum powers /* Accepted values */// Integer greater than 0.

connectors

Filter to include only stations that have EVSEs with the specified connector types. Accepts an array of strings with any OCPI 2.2.1 connector values.

Show query example

          ?connectors[]=CHADEMO&connectors[]=IEC_62196_T2_COMBO /* Default value */// All connectors /* Accepted values */// CHADEMO// DOMESTIC_A// DOMESTIC_B// DOMESTIC_C// DOMESTIC_D// DOMESTIC_E// DOMESTIC_F// DOMESTIC_G// DOMESTIC_H// DOMESTIC_I// DOMESTIC_J// DOMESTIC_K// DOMESTIC_L// DOMESTIC_M// DOMESTIC_N// DOMESTIC_O// IEC_60309_2_single_16// IEC_60309_2_three_16// IEC_60309_2_three_32// IEC_60309_2_three_64// IEC_62196_T1// IEC_62196_T1_COMBO// IEC_62196_T2// IEC_62196_T2_COMBO// IEC_62196_T3A// IEC_62196_T3C// PANTOGRAPH_BOTTOM_UP// PANTOGRAPH_TOP_DOWN// TESLA_R// TESLA_S// GB_T// CHAOJI// NEMA_5_20// NEMA_6_30// NEMA_6_50// NEMA_10_30// NEMA_10_50// NEMA_14_30// NEMA_14_50

evse_statuses

Filter to include only stations with EVSEs that have the specified statuses.

Show query example

          ?evse_statuses[]=AVAILABLE&evse_statuses[]=CHARGING

Filter combinations & logic

Filters can be combined in two ways.

Same filter type, multiple values
- When multiple values are provided for the same filter parameter, the logic depends on the filter type.
  
  Amenities filter: Station must match all specified values (AND logic). ?Amenities[]=toilet&?Amenities[]=restaurant -> Returns only stations near at least a toilet AND a restaurant
  
  All other filters: Station must match any of the specified values (OR logic)?connectors[]=IEC_62196_T1_COMBO&connectors[]=CHADEMO -> Returns stations with at least one IEC_62196_T1_COMBO OR CHADEMO connector.
Multiple different filter types
- When different filter types are combined, the station must satisfy all filters (AND logic). ?minimum_power=120 & evse_statuses[]=AVAILABLE & connectors[]=IEC_62196_T1_COMBO -> Returns stations with at least one AVAILABLE IEC_62196_T1_COMBO connector rated at 120kW+.

Data transformations

When EVSE-Level filters are applied the stations properties connector_maximum_power and evse_status_* are re-calculated to reflect only the connectors that match filtering criteria.

This station serves as reference point for how data transformations occur based on different filter parameters.

Station A
1x Combo Type 1 (IEC_62196_T1_COMBO), Available, 150 kW
1x Combo Type 1 (IEC_62196_T1_COMBO), Out of Order, 150 kW
1x CHAdeMO, Available, 100 kW
Belongs to a prefered operator

Request without filters

When no filters are applied, all stations are returned and the response reflects the aggregate data of all the stations evses.

Data transformations / Without filters response

          {  "id": "station_a",// Static: The station's absolute maximum power   "station_maximum_power": 150,    // Dynamic: Reflects the maximum power available across all connectors since no filters are applied  "connector_maximum_power": 150,  // Dynamic: Counts all available connectors  "evse_status_available": 2, // Dynamic: Counts all out-of-order connectors  "evse_status_out_of_order":1 }

Request with Station-Level filters

Filter: ?preferred_operator=true

In this example the station is returned because matches the operator criteria and no re-calculations are done.

Data transformations / Filters response

          {  "id": "station_a",// Static: The station's absolute maximum power   "station_maximum_power": 150,    // Dynamic: Reflects the maximum power available across all connectors since no filters are applied  "connector_maximum_power": 150,  // Dynamic: Counts all available connectors  "evse_status_available": 2, // Dynamic: Counts all out-of-order connectors  "evse_status_out_of_order":1 }

Request with EVSE-Level filters

Filter: ?preferred_operator=true & connectors[]=CHADEMO

In this example, the station is returned because it matches operator criteria and the EVSE-Level filter (connector_type CHAdeMO is present). The dynamic fields are recalculated to "mask" any hardware that isn't a CHAdeMO connector.

Data transformations / Filters response

          {  "id": "station_a",  // Static: Remains 150 kW (This represents the station maximum power across all conectors)  "station_maximum_power": 150,      // Dynamic: Adjusted to 100 kW (Max power of the CHADEMO connector)  "connector_maximum_power": 100,    // Dynamic: Counts the 1 CHADEMO chargers   "evse_status_available": 1,        // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evse_status_out_of_order": 0    }