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 that do not meet the criteria are removed. For the remaining stations, the dynamic properties - evses_* and connector_maximum_power — are recalculated to reflect only the hardware satisfying the filters.

Implementation

Filter parameters are appended to the request URL as query strings to any of the Tile service endpoints (MVT , JSON, or Count). When no filters are applied, the API returns the full set of available charging stations and all properties reflect the station’s total configuration .

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 exclude non-matching stations but never transform the values of the returned data.

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 operators configured as "preferred". 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 operators configured as "excluded". 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 includes only stations operated by specific operator IDs.

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 (Car,Van,Rigid,Truck with Trailer) /* Accepted values */// Van// Rigid// Truck_with_trailer

EVSE-Level Filters

Filters that evaluate the station’s specific charging capabilities. These filters perform both exclusion (removing non-matching stations) and transformation (recalculating dynamic fields for matching stations).

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 station properties connector_maximum_power and evses_* 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  "evses_available": 2, // Dynamic: Counts all out-of-order connectors  "evses_out_of_order":1 }

Request with Station-Level filters

Filter: ?preferred_operator=true

In this example the station is returned because it matches the operator criteria and no re-calculations are performed as only a station-level filter was used.

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  "evses_available": 2, // Dynamic: Counts all out-of-order connectors  "evses_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 the 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   "evses_available": 1,        // Dynamic: 0, because the charging Type 1 plugs are filtered out  "evses_out_of_order": 0    }