Create or edit a tariff
/v1/projects/{projectId}/tariffsCreates a tariff: what drivers pay to charge, made up of any mix of an energy price, a charging-time price, an idle-time price and fixed fees, each with optional conditions such as time of day.
To edit an existing tariff, send its tariffId. Editing never changes a version in place: it creates a new version, and earlier versions are kept so past sessions can still be priced as they were. Leave tariffId out to create a new tariff with an id Flowion assigns.
Instead of energy, a tariff can carry a spot rule: for each quarter-hour the driver pays the day-ahead market price of the bidding zone times a multiplier, plus named per-kWh parts such as a markup, the grid transfer and the energy tax, plus tax. Omit spot.zone to use the zone of the location the charger is at. Sending both energy and spot is refused.
A tariff applies nowhere until you assign it. If any price has a time-of-day or day-of-week condition, the project needs a time zone first.
Authorization
Authorizationheader · stringrequiredBearer <token>, with an ID token from a console sign-in or an API key (flw_ak_…). How authentication works
Parameters
projectIdpath · uuidrequiredThe project to create the tariff in.
Request body
currencystringrequiredThree-letter ISO 4217 code, for exampleSEK.chargingTimeobjectnullableA price per minute while the car is charging.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceMinutestringrequiredThe price per minute, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
descriptionarray of objectText explaining the tariff to drivers, in one or more languages.3 child fields
contentstringrequiredThe text.formatstringrequiredHowcontentis written, for exampleUTF8,ASCII,HTMLorURI.languagestringnullableThe language, as a code such asenorsv.
energyobjectnullableA price per kWh.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceKwhstringrequiredThe price per kWh, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
fixedFeeobjectnullableA fixed fee per session, for example a start fee.2 child fields
pricesarray of objectrequiredOne or more fees, each with optional conditions.2 child fields
priceFixedstringrequiredThe fee, excluding tax, as a decimal string.conditionsobjectnullableWhen the fee applies. Absent means always.8 child fields
dayOfWeekarray of stringThe days the fee applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the fee stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the fee applies to.paymentBrandstringnullableApplies only when the driver pays with this payment brand. Up to 20 characters.paymentRecognitionstringnullableApplies only to this kind of payment at the charger, for exampleCCorDebit. Up to 20 characters.startTimeOfDaystringnullableLocal time the fee starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the fee applies, asYYYY-MM-DD.validToDatedatenullableThe date the fee stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these fees. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
idleTimeobjectnullableA price per minute while the car is plugged in but not charging.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceMinutestringrequiredThe price per minute, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
maxCostobjectnullableThe most a session can cost under this tariff.2 child fields
exclTaxstringnullableThe amount excluding tax.inclTaxstringnullableThe amount including tax.
minCostobjectnullableThe least a session costs under this tariff.2 child fields
exclTaxstringnullableThe amount excluding tax.inclTaxstringnullableThe amount including tax.
reservationFixedobjectnullableA fixed fee for a reservation.2 child fields
pricesarray of objectrequiredOne or more fees, each with optional conditions.2 child fields
priceFixedstringrequiredThe fee, excluding tax, as a decimal string.conditionsobjectnullableWhen the fee applies. Absent means always.8 child fields
dayOfWeekarray of stringThe days the fee applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the fee stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the fee applies to.paymentBrandstringnullableApplies only when the driver pays with this payment brand. Up to 20 characters.paymentRecognitionstringnullableApplies only to this kind of payment at the charger, for exampleCCorDebit. Up to 20 characters.startTimeOfDaystringnullableLocal time the fee starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the fee applies, asYYYY-MM-DD.validToDatedatenullableThe date the fee stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these fees. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
reservationTimeobjectnullableA price per minute for a reservation.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceMinutestringrequiredThe price per minute, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
spotobjectnullable4 child fields
multiplierstringrequiredpartsarray of object2 child fields
amountPerKwhstringrequirednamestringrequired
taxRatesarray of object3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
zonestringnullable
tariffIdstringnullableThe tariff to edit. Leave it out to create a new tariff with an id Flowion assigns. 1–60 characters: letters, digits,.,_,:and-.validFromdate-timenullableWhen this version takes effect. Absent means immediately.
Responses
The tariff, or its new version, was created.
createdAtdate-timerequiredWhen this version was created.currencystringrequiredThree-letter ISO 4217 code.tariffIdstringrequiredThe tariff's id. It stays the same across versions.versionintegerrequiredThe version number. Each edit adds one.chargingTimeobjectnullableA price per minute while the car is charging.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceMinutestringrequiredThe price per minute, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
descriptionarray of objectText explaining the tariff to drivers, in one or more languages.3 child fields
contentstringrequiredThe text.formatstringrequiredHowcontentis written, for exampleUTF8,ASCII,HTMLorURI.languagestringnullableThe language, as a code such asenorsv.
energyobjectnullableA price per kWh.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceKwhstringrequiredThe price per kWh, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
fixedFeeobjectnullableA fixed fee per session, for example a start fee.2 child fields
pricesarray of objectrequiredOne or more fees, each with optional conditions.2 child fields
priceFixedstringrequiredThe fee, excluding tax, as a decimal string.conditionsobjectnullableWhen the fee applies. Absent means always.8 child fields
dayOfWeekarray of stringThe days the fee applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the fee stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the fee applies to.paymentBrandstringnullableApplies only when the driver pays with this payment brand. Up to 20 characters.paymentRecognitionstringnullableApplies only to this kind of payment at the charger, for exampleCCorDebit. Up to 20 characters.startTimeOfDaystringnullableLocal time the fee starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the fee applies, asYYYY-MM-DD.validToDatedatenullableThe date the fee stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these fees. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
idleTimeobjectnullableA price per minute while the car is plugged in but not charging.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceMinutestringrequiredThe price per minute, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
maxCostobjectnullableThe most a session can cost under this tariff.2 child fields
exclTaxstringnullableThe amount excluding tax.inclTaxstringnullableThe amount including tax.
minCostobjectnullableThe least a session costs under this tariff.2 child fields
exclTaxstringnullableThe amount excluding tax.inclTaxstringnullableThe amount including tax.
projectIduuidnullableThe project that owns the tariff.reservationFixedobjectnullableA fixed fee for a reservation.2 child fields
pricesarray of objectrequiredOne or more fees, each with optional conditions.2 child fields
priceFixedstringrequiredThe fee, excluding tax, as a decimal string.conditionsobjectnullableWhen the fee applies. Absent means always.8 child fields
dayOfWeekarray of stringThe days the fee applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the fee stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the fee applies to.paymentBrandstringnullableApplies only when the driver pays with this payment brand. Up to 20 characters.paymentRecognitionstringnullableApplies only to this kind of payment at the charger, for exampleCCorDebit. Up to 20 characters.startTimeOfDaystringnullableLocal time the fee starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the fee applies, asYYYY-MM-DD.validToDatedatenullableThe date the fee stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these fees. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
reservationTimeobjectnullableA price per minute for a reservation.2 child fields
pricesarray of objectrequiredOne or more prices, each with optional conditions.2 child fields
priceMinutestringrequiredThe price per minute, excluding tax, as a decimal string.conditionsobjectnullableWhen the price applies. Absent means always.18 child fields
dayOfWeekarray of stringThe days the price applies,MondaytoSunday.endTimeOfDaystringnullableLocal time the price stops applying, asHH:MM. Earlier thanstartTimeOfDaymeans the window runs past midnight; use00:00to run to the end of the day.evseKindstringnullableACorDC: the kind of charging the price applies to.maxChargingTimeintegernullableApplies while the session has charged for less than this many seconds.maxCurrentstringnullableApplies while the car draws less than this current, in amps, summed over all phases.maxEnergystringnullableApplies until the session has used this much energy, in Wh.maxIdleTimeintegernullableApplies while the car has been idle for less than this many seconds.maxPowerstringnullableApplies while the car draws less than this power, in W.maxTimeintegernullableApplies while the session, charging and idle together, has lasted less than this many seconds.minChargingTimeintegernullableApplies once the session has charged for this many seconds.minCurrentstringnullableApplies while the car draws at least this current, in amps, summed over all phases.minEnergystringnullableApplies once the session has used this much energy, in Wh.minIdleTimeintegernullableApplies once the car has been idle for this many seconds.minPowerstringnullableApplies while the car draws at least this power, in W.minTimeintegernullableApplies once the session, charging and idle together, has lasted this many seconds.startTimeOfDaystringnullableLocal time the price starts applying, asHH:MMin 24-hour time.validFromDatedatenullableThe first date the price applies, asYYYY-MM-DD.validToDatedatenullableThe date the price stops applying, asYYYY-MM-DD.
taxRatesarray of objectTaxes added to these prices. Leaving it out means no tax, which is not the same as a 0% rate.3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
spotobjectnullable4 child fields
multiplierstringrequiredpartsarray of object2 child fields
amountPerKwhstringrequirednamestringrequired
taxRatesarray of object3 child fields
taxstringrequiredThe tax percentage, as a decimal string, for example"25".typestringrequiredA label for the tax, for exampleVAT, shown on receipts. Up to 20 characters.stackintegerThe order taxes are applied in when there are several.0is applied to the price itself,1on top of the result of0, and so on. Defaults to0.
zonestringnullable
supersededAtdate-timenullableWhen a newer version replaced this one. Absent on the latest version.validFromdate-timenullableWhen this version takes effect. Absent means as soon as it was created.
Headers
Locationheader · stringRateLimit-Limitheader · stringRateLimit-Remainingheader · stringRateLimit-Resetheader · string
The tariff isn't valid: for example minCost or maxCost has neither a tax-exclusive nor a tax-inclusive amount, tariffId breaks its format, or a time condition could never match (a time that isn't HH:MM, an unknown day, or a start and end at the same minute). Also refused: both energy and spot (tariffEnergyAndSpot), a spot.zone whose prices are in another currency than the tariff's (spotCurrencyMismatch), and a spot rule with a multiplier of 0 or less, more than 8 parts, or two parts with one name. The message names the field.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
Your token is missing, has expired or isn't valid. Sign in again, or use a valid API key.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
The project doesn't exist, you can't access it, or tariffId names no tariff in it.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
A price has a time-of-day or day-of-week condition and the project has no time zone. Set the project's time zone and try again.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
Too many requests. Wait the number of seconds in Retry-After, then try again.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
Headers
Retry-Afterheader · stringX-RateLimit-Afterheader · string
Something went wrong on our side. Try again, and if it keeps happening, contact support with the response's requestId.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
Pricing is temporarily unavailable. Try again shortly.
errorenumrequiredA stable code for the error. Switch on this value: it doesn't change between releases.One ofaccountHasOpenBalanceaccountNotReadyalreadyStartedambiguousIdTokenambiguousReservationAddressassetServiceUnavailableassistantCardRequiredassistantDisabledassistantLimitReachedinstallerPhotoDayLimitinstallerPhotoConversationLimitassistantNotEnabledassistantRouteNotAllowedassistantUnavailableauthenticationRequiredauthorizationUnavailablebadRequestbatchTooLargebillingAccountClosedbillingAccountSuspendedbillingNotConfiguredbillingServiceUnavailablecannotDeleteDefaultcapacityExceededcardAlreadyHeldcardBlockedcardOwnedByPrincipalcertificateAuthorityServiceUnavailablechargerUnsafeForHoldcircuitChosenTwicecircuitNotFoundcircuitNotOnJobLocationchargerNotRunningchargePointIdTakenchargerSplitAcrossLocationschargingStationNotAcceptedclaimNotEligibleclaimNotFoundcommandNotSupportedcommandTypeRemovedcommandsUnavailableconflictconfirmationInvalidconfirmationLockedconfirmationNotSentconfirmationRequiredconfirmEraseRequiredconsentMissingconversationClosedconversationBusyconnectionNotEligibleconnectorAlreadyOccupiedconnectorNotFoundconnectorNotOccupiedconfirmOverPlanRequiredcsmsManagedSettingdeclineddiagnosticsReceiverServiceUnavailablediagnosticsRequestOutstandingdiagnosticsUnsupportedProtocolVersiondisconnectedduplicateeaseeCircuitUnmappedeaseeSiteClaimedElsewhereeaseeUnreachableeaseeWrongSerialOrPinemailNotVerifiedemptyEventTypesemptyLimitemptyTransactionLimitenergyControllerUnavailableenergyPricingServiceUnavailableeventTypeNotSubscribableexceedsCapabilityfileExpiredfileNotAvailablefirmwareIdentityUnknownforbiddenhandoverNotReadyhasChildCircuitsholdAmountOutOfRangeholdNotAuthorizedidTokenNotAcceptedidTokenNotRecoverableidempotencyKeyConflictidempotencyKeyInFlightidempotencyKeyReplayedidempotencyStoreUnavailableintegrationEaseeServiceUnavailableintegrationUnavailableconnectionsServiceUnavailableinternalErrorinvalidinvalidAddressinvalidAppDestinationinvalidClientinvalidCoordinatesinvalidCountryinvalidCurrentTypeinvalidEvsesinvalidCursorinvalidErrorCodeinvalidIdTokeninvalidLineinvalidModeinvalidMonitorAssignmentinvalidMonitorConnectioninvalidNameinvalidPaginationinvalidRedirectUriinvalidReasoninvalidPhaseCountinvalidRequestinvalidImageimageTooLargeinvalidWindowmethodNotUsablenotAPaidChargernotCapturedoverRefundpaymentRequiredrevisionConflictinvalidScheduleinvalidScopeinvalidSettingValueinvalidLocationTargetinvalidSluginvalidStartingSocinvalidTargetSocinvalidTargetinvalidTargetUrlinvalidTariffinvalidTariffConditioninvalidTariffIdinvalidTimeZoneinvalidUrlinvalidValueinstallerNotHeldinvitationAlreadyAcceptedinvitationExpiredjobsServiceUnavailableopenJobsservesCustomerGrantsnotAnInstallationsProjectgrantNotActivelastCircuitOnLocationlocationUnderInstallationlocationNotBuiltlocationAlreadyBuiltmetricsStoreErrormetricsStoreUnavailablemessageTooLongmissingIdTokenmissingIdempotencyKeymonitorConflictmonitorNotFoundmqttServiceUnavailablemissingOrMalformedHeaderinvalidTokenjwksUnavailableapiKeyServiceUnavailablenotConnectednotDispatchablenotEntitledassigneeCannotReadJobnotFoundnotReadynotSandboxModenoFirmwareCatalogednoOpenSessionnoSupportedTransferProtocolnoVehicleocppUnavailableorganizationNotEmptyownerCannotLeaveownsOrganizationspaymentMethodRequiredbinding.driver_policy_requires_access_permissionbinding.holder_outside_home_projectpermission_policy.deny_not_allowedpermission_policy.deny_on_owner_floorpermission_policy.in_usepermission_policy.invalid_documentpermission_policy.limit_exceededpermission_policy.managed_immutablepermission_policy.management_permission_for_non_memberpermission_policy.name_takenpermission_policy.not_grantablepermission_policy.unknown_permissionpermission_policy.would_remove_last_editorpaymentsAccountNotFoundpaymentsAccountSubmittedpaymentsOrganizationSyntheticpaymentsUnavailablephaseTopologyNotConfirmedprincipalErasedprincipalInactiveprincipalNotFoundprojectNotFoundproposalAlreadyDecidedprotocolErrorrateLimitErrorrateLimitedratedCurrentNotPositivereferenceTakensandboxOrganizationChargerLimitReachedsandboxProjectChargerLimitReachedsandboxStationRefusedselfParentsellerUnavailableserviceUnavailablesessionServiceUnavailablestationOfflinesigningSecretTooShortsiteClaimedElsewheresiteOwnedByAnotherEaseeOperatorslugChangeNotAcknowledgedslugTakenspotCurrencyMismatchtariffEnergyAndSpottimeZoneRequiredtimedOutscopeNotGrantedscopeTooLargewindowEndedwindowTooLongsessionCapExceededinvalidMonthmonthTooLargemixedCurrenciesmonthNotClosablemonthHasOpenHoldsmonthAlreadyClosedmonthNotClosedoutcomeFinalmonthClosednotCarriabletargetMonthClosedsettlementServiceUnavailabletransactionAlreadyOpentransactionNotOpenunauthorizedunavailableunintelligibleResponseunknownBiddingZoneunknownChargerModelunknownEventTypeunknownFallbackStatusunknownSerialunknownVariableunknownVehicleModelunprocessableunrecognisedApiKeyModeunrecognisedSessionModeunsupportedvendorManagedFirmwarevendorUnreachablevirtualChargerLimitReachedvirtualChargerOrganizationLimitReachedvirtualChargerServiceUnavailablevirtualChargerStateUnavailablewebhookServiceUnavailablewrongPinmessagestringrequiredA description for people. Its wording may change, so don't parse it.requestIdstringThis request's id, the same as thex-request-idresponse header. Quote it when you contact support.
Headers
Retry-Afterheader · string