Use the tariffs
endpoint to retrieve the raw tariffs that were shared with Eco-Movement by the CPOs using the OCPI protocol.
Caution
The tariffs endpoint is still active, but the prices endpoint is much more complete and is contributed by multiple sources.
The tariffs
endpoint provides a list of prices at the connector level. In locations
endpoint's result, the tariff_id
attribute corresponds with the tariffs endpoint.
Note
Eco-Movement recommends that you retrieve all the tariffs once a day or once a week.
Request
The request for the tariffs
endpoint contains a few query parameters.
See tariffs to know more about the parameters that are used with the tariffs
endpoint.
Response
The following is a sample response for the tariffs
endpoint:
{
data: [
element 1
[{...},{...}],
element 2
[{...},{...}]
],
}
Caution
Eco-Movement always upholds the API contract, but we may send new attributes in our JSON response when:
- we add an OCPI mandatory attribute to the JSON response to be OCPI compliant
- we improve your licensing module with new features
Hence, we strongly recommend that you handle or ignore unknown JSON fields.
Response Definitions
The following are the attributes for the tariffs
endpoint:
Attribute | Description |
---|---|
| The unique id for a tariff. |
| The three digit currency code of the country where the charging station is located. |
| A list of multi language alternative tariff information text. |
| The alternative URL for tariff information. |
| The timestamp when the Tariff was last updated or |
| The unique ID of the tariff in the system of the CPO. |
| The list of tariff elements. |
| The list of price components that make up the |
| The type of tariff. The different types of tariff are:
|
| The price per unit for the tariff type. |
| Indicates the minimum amount that is billed. A
|
| The list of restrictions for the tariff. The restrictions are:
|