Get details of multiple tariffs given a charge at…
This API follows the https://jsonapi.org specification.
ViewPriceBenchmark
API-Key: <your_api_key> (contact sales@chargeprice.net to get access)Content-Type: application/jsonThe following fields are to be sent in the request body, in the attributes section:
| Name | Type | Presence | Example | Description |
|---|---|---|---|---|
| station | Object | required | Station reference | |
| station.country | String | required | AT |
ISO 3166 country code of the location |
| station.operator | Object | required | Operator of the station | |
| station.operator.id | String | required | 20006f18-3ed4-4715-92b5-08e37e6dd18c |
ID of the operator company |
| station.operator.type | String | required | company |
Type of the company (always company for now) |
The following table lists the relationships section:
| Name | Type | Presence | Example | Description |
|---|---|---|---|---|
| tariffs | Array of Relationships | optional | [{"id": "some-uuid", type:"tariff" }] |
Details for the those tariffs should be returned. |
The emp and tariff relationship are included per default.
See the response of the included section.
The following table lists the attributes of these objects:
| Name | Type | Example | Description |
|---|---|---|---|
| updated_at | Timestamp | 1664446527000 | Time when the tariff has been updated |
| restricted_segments | Array | - | |
| restricted_segments.dimension | String | minute |
Either “minute”, “kwh” or “session” |
| restricted_segments.price | Float | 0.39 | The price per dimension. |
| restricted_segments.range_gte | Integer | 60 | From which dimension value the price applies. e.g. from 60 minutes on. |
| restricted_segments.range_lt | Integer | 120 | Until which dimension value the price applies. e.g. until 120 minutes. |
| restricted_segments.billing_increment | Float | 10 | e.g. if dimension is minute and billing increment is 10, the customer is charged in blocks of any started 10 minutes. |
| restricted_segments.currency | String | EUR |
The currency of this component. Overrules the currency of the tariff. |
| restricted_segments.time_of_day_start | Integer | 720 | Time of day when this segment starts to count or gets active. In minutes. |
| restricted_segments.time_of_day_end | Integer | 1200 | Time of day when this segment stops to count or be active. In minutes. |
| restricted_segments.charge_point_powers | Array |
[0.0,22.0] | List of valid power values of the charge point |
| restricted_segments.charge_point_energy_type | String | ac |
Valid power/phase. Either “ac”, “dc” or null if it applies for both. |
| restricted_segments.car_ac_phase | Integer | 3 | Valid AC phases of the car. |
| restricted_segments.charge_point_power_is_range | Boolean | true |
true: List of charge_point_powers needs to have two values, which define a range of valid values (first value needs to be <= second value). False: Only the specifc values are valid. |
| restricted_segments.use_consumed_charging_power | Boolean | false |
if true: The consumed power of the car defines the price, instead of the maximum power of the station. |
The following table lists the relationships and their values in the included section:
| Name | Type | Example | Description |
|---|---|---|---|
| tariff | Relationship | {"id": "some-uuid", type:"tariff" } |
The tariff for which the details are given. |
| tariff.name | String | easyFlex |
Name of the tariff |
| tariff.total_monthly_fee | Float | 10.0 | Monthly fee incl. a 12th of any yearly fee. |
| tariff.currency | String | EUR |
Main currency of the tariff. Applies to e.g. the monthly fee. Currency of prices can vary country by country. |
| emp | Relationship | {"id": "some-uuid", type:"company" } |
The EMP (E-Mobility Service Provider) who offers the tariff. |
| emp.name | String | Energie Steiermark |
Company name of the EMP |
| cpo | Relationship | {"id": "some-uuid", type:"company" } |
The CPO (Charge Point Operator) to which this tariff applies. |
Timestamp = Millis since 1.1.1970
POST http://example-base-url.com/v1/tariff_details
Content-Type: application/json
Api-Key: my-secret-key
Body:
{
"data": {
"attributes": {
"station": {
"country": "AT",
"operator": {
"id": "50006f18-3ed4-4715-92b5-08e37e6dd18c",
"type": "company"
}
}
},
"relationships": {
"tariffs": {
"data": [
{
"id": "20006f18-3ed4-4715-92b5-08e37e6dd18c",
"type": "tariff"
}
]
}
}
}
}
Body:
{
"data": [
{
"id": "40006f18-3ed4-4715-92b5-08e37e6dd18c",
"type": "station_tariff_details",
"attributes": {
"updated_at": 1546300800000,
"restricted_segments": [
{
"dimension": "kwh",
"price": 2.0,
"range_gte": null,
"range_lt": null,
"billing_increment": 0.01,
"currency": "EUR",
"time_of_day_start": null,
"time_of_day_end": null,
"charge_point_powers": [
0.0,
22.0
],
"charge_point_energy_type": "ac",
"car_ac_phase": 2,
"charge_point_power_is_range": true,
"use_consumed_charging_power": false
}
]
},
"relationships": {
"emp": {
"data": {
"type": "company",
"id": "10006f18-3ed4-4715-92b5-08e37e6dd18c"
}
},
"tariff": {
"data": {
"type": "tariff",
"id": "20006f18-3ed4-4715-92b5-08e37e6dd18c"
}
},
"cpo": {
"data": {
"type": "company",
"id": "50006f18-3ed4-4715-92b5-08e37e6dd18c"
}
}
}
}
],
"included": [
{
"id": "10006f18-3ed4-4715-92b5-08e37e6dd18c",
"type": "company",
"attributes": {
"name": "Energie Steiermark",
}
},
{
"id": "20006f18-3ed4-4715-92b5-08e37e6dd18c",
"type": "tariff",
"attributes": {
"name": "easyFlex",
"total_monthly_fee": 5.0,
"currency": "EUR"
}
}
]
}
Client provided invalid request body.
{
"errors": [
{
"status": "400",
"code": "BAD_REQUEST",
"title": "..."
}
]
}
{
"errors": [
{
"status": "403",
"code": "FORBIDDEN",
"title": "api_key missing"
}
]
}
An unexpected error happened.
{
"errors": [
{
"status": "500",
"code": "INTERNAL_SERVER_ERROR",
"title": "some error"
}
]
}