Tariffs

Pricing rules for charging sessions

GET `/tariffs` List tariffs

Parameters

Name	In	Type	Required	Description
`page`	query	integer
`per_page`	query	integer

Responses

200 Tariff list

Property Type Required Description

data array<Tariff>

Property Type Required Description

id string required

name stringnullable

currency string required

elements array<TariffElement> required

Property Type Required Description

price_components array<PriceComponent> required

Property	Type	Required	Description
`type`	enum `ENERGY` `FLAT` `TIME` `PARKING_TIME`	required
`price`	numberformat: double	required	Price per unit (excl. VAT)
`step_size`	integer	required	Minimum billable unit (e.g., 1000 for per-kWh billing on Wh meter)

restrictions TariffRestriction

Property	Type	Description
`start_time`	string	HH:MM format
`end_time`	string
`min_kwh`	number
`max_kwh`	number
`day_of_week`	array<enum>

created_at stringformat: date-time required

updated_at stringformat: date-time

pagination Pagination

Property	Type	Required
`total`	integer	required
`page`	integer	required
`per_page`	integer	required
`has_more`	boolean	required

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X GET "https://api.ampr.dev/v1/tariffs" \
  -H "Authorization: Bearer $AMPR_API_KEY"

const res = await fetch('https://api.ampr.dev/v1/tariffs', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
  },
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

POST `/tariffs` Create a tariff

Request body

Property Type Required Description

name string

currency string required

elements array<TariffElement> required

Property Type Required Description

price_components array<PriceComponent> required

Property	Type	Required	Description
`type`	enum `ENERGY` `FLAT` `TIME` `PARKING_TIME`	required
`price`	numberformat: double	required	Price per unit (excl. VAT)
`step_size`	integer	required	Minimum billable unit (e.g., 1000 for per-kWh billing on Wh meter)

restrictions TariffRestriction

Property	Type	Description
`start_time`	string	HH:MM format
`end_time`	string
`min_kwh`	number
`max_kwh`	number
`day_of_week`	array<enum>

Responses

201 Tariff created

Property Type Required Description

data Tariff

Property Type Required Description

id string required

name stringnullable

currency string required

elements array<TariffElement> required

Property Type Required Description

price_components array<PriceComponent> required

Property	Type	Required	Description
`type`	enum `ENERGY` `FLAT` `TIME` `PARKING_TIME`	required
`price`	numberformat: double	required	Price per unit (excl. VAT)
`step_size`	integer	required	Minimum billable unit (e.g., 1000 for per-kWh billing on Wh meter)

restrictions TariffRestriction

Property	Type	Description
`start_time`	string	HH:MM format
`end_time`	string
`min_kwh`	number
`max_kwh`	number
`day_of_week`	array<enum>

created_at stringformat: date-time required

updated_at stringformat: date-time

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X POST "https://api.ampr.dev/v1/tariffs" \
  -H "Authorization: Bearer $AMPR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "currency": "string",
    "elements": [
      {}
    ]
  }'

const res = await fetch('https://api.ampr.dev/v1/tariffs', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "string",
    "currency": "string",
    "elements": [
      {}
    ]
  }),
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

GET `/tariffs/{tariff_id}` Get tariff detail

Parameters

Name	In	Type	Required	Description
`tariff_id`	path	string	required

Responses

200 Tariff detail

Property Type Required Description

data Tariff

Property Type Required Description

id string required

name stringnullable

currency string required

elements array<TariffElement> required

Property Type Required Description

price_components array<PriceComponent> required

Property	Type	Required	Description
`type`	enum `ENERGY` `FLAT` `TIME` `PARKING_TIME`	required
`price`	numberformat: double	required	Price per unit (excl. VAT)
`step_size`	integer	required	Minimum billable unit (e.g., 1000 for per-kWh billing on Wh meter)

restrictions TariffRestriction

Property	Type	Description
`start_time`	string	HH:MM format
`end_time`	string
`min_kwh`	number
`max_kwh`	number
`day_of_week`	array<enum>

created_at stringformat: date-time required

updated_at stringformat: date-time

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

404 Resource not found application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X GET "https://api.ampr.dev/v1/tariffs/trf_example" \
  -H "Authorization: Bearer $AMPR_API_KEY"

const res = await fetch('https://api.ampr.dev/v1/tariffs/trf_example', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
  },
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

DELETE `/tariffs/{tariff_id}` Delete tariff

Parameters

Name	In	Type	Required	Description
`tariff_id`	path	string	required

Responses

204 Tariff deleted

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

404 Resource not found application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

409 Resource conflict (e.g., duplicate serial, active session) application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X DELETE "https://api.ampr.dev/v1/tariffs/trf_example" \
  -H "Authorization: Bearer $AMPR_API_KEY"

const res = await fetch('https://api.ampr.dev/v1/tariffs/trf_example', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
  },
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

PATCH `/tariffs/{tariff_id}` Update tariff

Parameters

Name	In	Type	Required	Description
`tariff_id`	path	string	required

Request body

Property Type Required Description

name string

elements array<TariffElement>

Property Type Required Description

price_components array<PriceComponent> required

Property	Type	Required	Description
`type`	enum `ENERGY` `FLAT` `TIME` `PARKING_TIME`	required
`price`	numberformat: double	required	Price per unit (excl. VAT)
`step_size`	integer	required	Minimum billable unit (e.g., 1000 for per-kWh billing on Wh meter)

restrictions TariffRestriction

Property	Type	Description
`start_time`	string	HH:MM format
`end_time`	string
`min_kwh`	number
`max_kwh`	number
`day_of_week`	array<enum>

Responses

200 Tariff updated

Property Type Required Description

data Tariff

Property Type Required Description

id string required

name stringnullable

currency string required

elements array<TariffElement> required

Property Type Required Description

price_components array<PriceComponent> required

Property	Type	Required	Description
`type`	enum `ENERGY` `FLAT` `TIME` `PARKING_TIME`	required
`price`	numberformat: double	required	Price per unit (excl. VAT)
`step_size`	integer	required	Minimum billable unit (e.g., 1000 for per-kWh billing on Wh meter)

restrictions TariffRestriction

Property	Type	Description
`start_time`	string	HH:MM format
`end_time`	string
`min_kwh`	number
`max_kwh`	number
`day_of_week`	array<enum>

created_at stringformat: date-time required

updated_at stringformat: date-time

401 Missing or invalid API key application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

404 Resource not found application/problem+json

Property	Type	Required
`type`	stringformat: uri	required
`title`	string	required
`status`	integer	required
`detail`	stringnullable
`instance`	stringnullable

Request example

curl -X PATCH "https://api.ampr.dev/v1/tariffs/trf_example" \
  -H "Authorization: Bearer $AMPR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "string",
    "elements": [
      {}
    ]
  }'

const res = await fetch('https://api.ampr.dev/v1/tariffs/trf_example', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.AMPR_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "string",
    "elements": [
      {}
    ]
  }),
});
const data = await res.json();

Note

This endpoint requires an API key. Send it as a Bearer token in the Authorization header.

Tariffs

GET /tariffs List tariffs

Parameters

Responses

Request example

POST /tariffs Create a tariff

Request body

Responses

Request example

GET /tariffs/{tariff_id} Get tariff detail

Parameters

Responses

Request example

DELETE /tariffs/{tariff_id} Delete tariff

Parameters

Responses

Request example

PATCH /tariffs/{tariff_id} Update tariff

Parameters

Request body

Responses

Request example

GET `/tariffs` List tariffs

POST `/tariffs` Create a tariff

GET `/tariffs/{tariff_id}` Get tariff detail

DELETE `/tariffs/{tariff_id}` Delete tariff

PATCH `/tariffs/{tariff_id}` Update tariff