# Get charging station tariffs `POST https://bemap.benomad.com/bgis/service/chargingstation/tariffs/1.0/search` Part of [Charging stations](https://benomad.com/dev/doc/bemap-api/electric-mobility/charging-stations.md). > **Look up charging prices.** What charging costs at a station, for a data provider, a charge pass and a connector. Returns tariff information based on providers, charge passes, and connectors. Requires the Charging station search or EV smart routing option (Allow to get the charging station information); without it BeMap answers `400 Access Denied`. ## Request body JSON, `Content-Type: application/json`. Schema `ChargingStationTariffsRequest`. - `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 `200`, schema `ChargingStationTariffsResponse`. - `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. ## Errors - `400`: Bad Request - `302`: no credentials were sent. Do not follow the redirect. - `401`: the account or the API key is wrong. How to read each one: [Errors](https://benomad.com/dev/doc/bemap-api/getting-started/errors.md). ## Example ```bash curl -X POST 'https://bemap.benomad.com/bgis/service/chargingstation/tariffs/1.0/search' \ -u 'YOUR_ACCOUNT:YOUR_API_KEY' \ --fail-with-body \ -H 'Content-Type: application/json' \ -d '{ "providerName": "ecoMovement", "links": [ { "poolId": "b7c3a764-7be6-11f1-8782-42010aa400b8", "chargingPointId": "CU-B90-0102-001-1", "connectorId": "11" } ] }' ``` Response captured from production, long arrays and strings shortened: ```json { "items": [ { "poolId": "b7c3a764-7be6-11f1-8782-42010aa400b8", "chargingPointId": "CU-B90-0102-001-1", "connectorId": "11", "tariffContent": { "id": "6aa763f5b8686f72600795e3", "providerName": "ecoMovement", "updateDate": 1789354983445, "providerUpdated": "2026-08-09T11:26:37Z", "providerTariffId": "8cef44632b99eedf177cb37e8cd9b9a0c589056b383239c9d4ef6762698e3c11", "type": "AD_HOC", "chargePass": { "hashId": "54f7f457a004285cbd9eeed89df76986", "networkName": "Qwello UK ltd", "title": "Adhoc price", "currency": "GBP", "subscriptionType": "n/a", "subscriptionFeeExclVat": 0 }, "currency": "EUR", "tariffItems": [ { "restriction": { "startDate": "2025-06-02", "minDuration": 50400 }, "prices": [ { "type": "TIME", "unit": "PER_HOUR", "price": 8.3333, "vat": 20, "minAmount": 3600 }, { "type": "PARKING_TIME", "unit": "PER_HOUR", "price": 8.3333, "vat": 20, "minAmount": 3600 } ] }, { "restriction": { "startDate": "2025-06-02", "maxDuration": 50400 }, "prices": [ { "type": "TIME", "unit": "PER_HOUR", "price": 7.6667, "vat": 20, "minAmount": 900 }, { "type": "PARKING_TIME", "unit": "PER_HOUR", "price": 7.6667, "vat": 20, "minAmount": 900 } ] } ] } }, { "poolId": "b7c3a764-7be6-11f1-8782-42010aa400b8", "chargingPointId": "CU-B90-0102-001-1", "connectorId": "11", "tariffContent": { "id": "6ab0c06e80d97200ef876d12", "providerName": "ecoMovement", "updateDate": 1789968483206, "providerUpdated": "2026-08-09T11:26:37Z", "providerTariffId": "8cef44632b99eedf177cb37e8cd9b9a0c589056b383239c9d4ef6762698e3c11", "type": "AD_HOC", "chargePass": { "hashId": "2bd9254a576a56832c6f3a769751ff9b", "networkName": "Qwello France SAS", "title": "Adhoc price", "currency": "EUR", "subscriptionType": "n/a", "subscriptionFeeExclVat": 0 }, "currency": "EUR", "tariffItems": [ { "restriction": { "startDate": "2025-06-02", "minDuration": 50400 }, "prices": [ { "type": "TIME", "unit": "PER_HOUR", "price": 8.3333, "vat": 20, "minAmount": 3600 }, { "type": "PARKING_TIME", "unit": "PER_HOUR", "price": 8.3333, "vat": 20, "minAmount": 3600 } ] }, { "restriction": { "startDate": "2025-06-02", "maxDuration": 50400 }, "prices": [ { "type": "TIME", "unit": "PER_HOUR", "price": 7.6667, "vat": 20, "minAmount": 900 }, { "type": "PARKING_TIME", "unit": "PER_HOUR", "price": 7.6667, "vat": 20, "minAmount": 900 } ] } ] } } ] } ``` ## Tutorials - [Step-by-Step: Compute a Charging Cost from Charging Station and Tariffs data](https://benomad.com/dev/doc/bemap-api/guides/tutorials/chargingcost-from-charging-station-tariffs.md) ## Reference pages - [Get charging station tariffs](https://benomad.com/dev/doc/bemap-api/guides/services/chargingstation-tariffs.md) - [Charging station filter v2](https://benomad.com/dev/doc/bemap-api/guides/reference/chargingstation-filter-v2.md) - [Charging station filter v1](https://benomad.com/dev/doc/bemap-api/guides/reference/chargingstation-filter-v1.md)