# Get charging station tariffs REST API, Service version 1.0.0 > API reference: [`POST /chargingstation/tariffs/1.0/search`](https://benomad.com/dev/doc/bemap-api/api/electric-mobility/chargingstation-tariffs-search.md) Returns the list of tariffs of charging stations. ## Summary 1. Request 1. Mandatory parameters 2. Response 1. Details of fields 2. Response samples ## Request The request must be sent with the HTTP method `POST` and the HTTP header `Content-Type` set to `application/json`. Sample: URI: `/bgis/service/chargingstation/tariffs/1.0/search` POST data: ```javascript { "providerName": "ecoMovement", "chargePassHashIds": [ "b6c2f14ed716704ba648926f26071da0", "b2c34a5e76b162327e29fd79ec1589ed" ], "links": [ { "poolId": "3c4b35cc-368f-11f0-94a6-42010aa40043", "chargingPointId": "FR*IOY*E448904", "connectorId": "1" } ] } ``` ### __Parameters__ - `providerName` (string, required): Provider name used by BeMap (bgis). - `links` (ChargingTariffConnectorLinkFront[], required): Represents a list of associations between charging tariffs and connectors. - `poolId` (string, required): Unique identifier of the charging pool. - `chargingPointId` (string, required): Unique identifier of the charging point. Use the ID field from charging station search service. - `connectorId` (string, required): Unique identifier of the charging connector. Use the operator ID field from charging station search service. - `stationId` (string): Unique identifier of the charging station. - `geoserver` (string): Geoserver name. - `swidx` (integer (int32), deprecated): Switch index. - `logTag` (string): Log tag is an UUID tag used during the request calculation in log and send to another provider (if need). - `chargePassHashIds` (string[]): Represents a collection of hashed identifiers for tariff charge passes added in response. The tariffs of charge passes are returned in response to the AD/HOC tariffs. The AD/HOC tariffs are always returned when they are available. ## Response ### Details of fields - `items` (FindTariffsItemFront[], required): List of tariffs. - `poolId` (string, required): Unique identifier of the charging pool. - `stationId` (string, required): Unique identifier of the charging station. - `chargingPointId` (string, required): Unique identifier of the charging point. - `connectorId` (string, required): Unique identifier of the charging connector. - `tariffContent` (ChargingTariffContentFront, required): Details of the charging tariff. - `id` (string, required): Unique identifier of database entry, generated by the database. - `providerName` (string, required): Provider name of data. - `updateDate` (integer (int64), required): Update date, time stamp in milliseconds. - `providerTariffId` (string, required): A unique identifier for the tariff provided by a charging service provider. This identifier is used to distinguish between various tariff plans or pricing structures offered by the provider. Typically assigned by the provider, it serves as a reference for mapping and managing charging tariffs. - `type` (enum, required): Represents the type of charging tariff applied in the context of a charging session. - `AD_HOC` - `MSP` - `CPO_SUB` - `chargePass` (ChargingTariffChargePassFront, required): The charge pass may provide information about specific subscription features, fees, or charge network details relevant to the charging process. - `hashId` (string, required): Unique identifier of charge pass. - `title` (string, required): Name of charge pass. - `networkName` (string): Unique name of charge network. - `description` (string): A brief description or summary of the station charge pass. - `currency` (string): Currency used for the subscription fee. This field stores the currency code or symbol used for the subscription fee. - `subscriptionType` (string): Type of subscription associated with the entity. This may denote the specific subscription model or tier for accessing the station service. - `subscriptionFeeExclVat` (number (float)): Subscription fee excluding VAT. This field stores the fee amount charged for a subscription before any value-added tax is applied. - `networkUrl` (string): URL link to the website of charge network. - `androidAppUrl` (string): URL link to the Android application of charge network. - `iosAppUrl` (string): URL link to the iOS application of charge network. - `currency` (string, required): Currency ISO 4217 Code. - `minPrice` (ChargingPriceTaxFront, required): When this field is set, the minimum cost of a Charging Session before taxes cannot be lower than this amount. - `excludeTax` (number (float), required): Represents the price of a charge without a tax. - `includeTax` (number (float), required): Represents the price of a charge with tax. The amount of money of this tax that is due. - `name` (string): The name of the tax. The intention is that Parties use short names where possible, e.g. VAT. - `maxPrice` (ChargingPriceTaxFront, required): When this field is set, the maximum cost of a Charging Session before taxes cannot exceed this amount. - `excludeTax` (number (float), required): Represents the price of a charge without a tax. - `includeTax` (number (float), required): Represents the price of a charge with tax. The amount of money of this tax that is due. - `name` (string): The name of the tax. The intention is that Parties use short names where possible, e.g. VAT. - `tariffItems` (ChargingTariffItemFront[], required): A list containing tariff items associated with the charging tariff. - `prices` (ChargingPrice[], required): List of price. - `type` (enum, required): Type of price dimension. - `FLAT`: flat fee, no unit. - `PARKING_TIME`: time not charging, defined in hours. - `ENERGY`: defined in kWh. - `TIME`: time charging, defined in hours. - `price` (number (float), required): Price per unit (excluding VAT) for this tariff dimension. - `unit` (enum): Unit of price. - `NA` - `PER_HOUR` - `PER_KWH` - `vat` (number (float)): Applicable VAT percentage for this tariff dimension. If omitted, no VAT is applicable. - `minAmount` (number (float)): Minimum amount to be billed. - `restriction` (ChargingPriceRestriction): Restriction information of prices. - `startTime` (string): Start time of day (hh:mm). - `endTime` (string): End time of day (hh:mm). - `startDate` (string): Start date (AAAA-MM-DD). - `endDate` (string): End date (AAAA-MM-DD). - `minKwh` (number (float)): Minimum used energy in kWh for this tariff to be valid. - `maxKwh` (number (float)): Maximum used energy in kWh for this tariff to be valid. - `minPower` (number (double)): Minimum power in kW for this tariff to be valid. - `maxPower` (number (double)): Maximum power in kW for this tariff to be valid. - `minDuration` (integer (int32)): Minimum duration in seconds for this tariff to be valid. - `maxDuration` (integer (int32)): Maximum duration in seconds for this tariff to be valid. - `dayOfWeek` (enum[]): List of day of the week for this tariff to be valid. Values can be MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY. - `MONDAY` - `TUESDAY` - `WEDNESDAY` - `THURSDAY` - `FRIDAY` - `SATURDAY` - `SUNDAY` - `providerUpdated` (string): Represents the date and time when the charging tariff information was last updated. This timestamp allows tracking changes and updates to the tariff details. - `tariffExplainTexts` (LanguageTextFront[]): A list of multilingual textual descriptions for explaining the tariff. - `language` (string, required): Language code (e.g., 'fr', 'en'). - `text` (string, required): The actual text content. - `tariffUrl` (string): URL to a web page that contains an explanation of the tariff information in human-readable form. ### Response samples JSON Sample: ```javascript { "items": [ { "poolId": "3c4b35cc-368f-11f0-94a6-42010aa40043", "chargingPointId": "FR*IOY*E448904", "connectorId": "1", "tariffContent": { "id": "696513356c695139442c3013", "providerName": "ecoMovement", "updateDate": 1768231464512, "providerUpdated": "2025-12-24T07:01:11Z", "providerTariffId": "e861f26fed5e26b956f34e6cc2439d11e7e9c4c5939465326224baf132b4b418", "type": "MSP", "chargePass": { "hashId": "b6c2f14ed716704ba648926f26071da0", "networkName": "EnBW", "title": "EnBW mobility+ Ladetarif M", "description": "monthly subscription", "currency": "EUR", "subscriptionType": "monthly", "subscriptionFeeExclVat": 5.0336 }, "currency": "EUR", "tariffItems": [ { "restriction": { "minDuration": 14400, "maxDuration": 21600 }, "prices": [ { "type": "ENERGY", "unit": "PER_KWH", "price": 0.4917, "vat": 20.0, "minAmount": 1.0 }, { "type": "PARKING_TIME", "unit": "PER_HOUR", "price": 5.0, "vat": 20.0, "minAmount": 60.0 } ] }, { "prices": [ { "type": "ENERGY", "unit": "PER_KWH", "price": 0.4917, "vat": 20.0, "minAmount": 1.0 } ] } ] } } ] } ```