Search option to choose the eMSP or CPO whose tariff the client wants
to see in the response. This parameter is effective only if the fields is
configured to return tariffs. This parameter can be included multiple times to
request tariffs from multiple providers. Adhoc tariffs are always included when
available and when tariff fields are requested, regardless of this search parameter.
The input is expected to be based on the response from the CountryMetadata
endpoint, including only eMSPs / CPOs that are relevant for the client.
Some eMSPs provide several tariffs (subscriptions / charge cards). The end user
is expected to subscribe to only a few of them, and is hence expected to be
interested in only the related tariffs. The available tariffs are listed in the
CountryMetadata response. If tariff name is not set or the name does not match
with the tariffs of the provider, all available tariffs for that provider for the
charging location are returned.
As tariff names may occassionally change, the client is encouraged to monitor
the list by regularly fetching the latest list of tariff names per eMSP or CPO
from the CountryMetadata endpoint.
If the returned tariffs for multiple locations do not contain a requested tariff
by the name, the client is recommended to try searching without any names.
If still no tariffs were returned, the reason may be that there are no tariffs
available for the locations, or that the partner has no roaming agreement for the
locations.
If the search by partnerId succeeds, the used tariff name may be outdated and the
client need to update the list from the CountryMetadata endpoint.
This search cannot be used to filter out locations not covered by the specified
eMSPs / CPOs.
The special keyword all can be used to request all available tariffs for the charging
location, including both ad-hoc and subscription tariffs including both eMSPs and CPOs.
When all is provided, the response will include every tariff type available,
regardless of provider or tariff name.