Log inTalk to us
Developer tools

Read a location's tax lines

get/v1/tenants/{tenant_id}/locations/{location_id}/tax
Requires an API key

The tax lines and price mode bills at this location take; configured false without any (no tax). Errors: 404 location_not_found. See Errors and statuses.

Path parameters

  • tenant_idintegerRequired
  • location_idintegerRequired

Returns · 200

  • location_idintegerRequired
  • configuredbooleanRequired
    false: no tax lines; bills at the location carry no tax.
  • price_modeenumRequired
    tax_exclusive (the US norm): tariff prices exclude tax and the lines are added to them. tax_inclusive: tariff prices include every line, and the lines are taken out of the price the driver pays.
    One of tax_exclusive, tax_inclusive
  • linesarray of TaxLineRecordRequired
    Child attributes
    • orderintegerRequired
      1 for the first line applied.
    • namestringRequired
    • typeenumRequired
      One of percent, per_kwh
    • ratestringRequired
      Decimal text: a percentage, or minor units per kWh.
    • compoundbooleanRequired
    • excluded_componentsarray of enumRequired
    • registration_numberstring | nullRequired
  • presetstring | nullRequired
    The preset this configuration was confirmed from, or null.
  • updated_bystring | nullRequired
  • updated_atstring | nullRequired
GET /v1/tenants/{tenant_id}/locations/{location_id}/tax
curl --fail-with-body "https://api.ivoracharge.com/v1/tenants/1042/locations/7/tax" \
  -H "Authorization: Bearer $IVORA_API_KEY"
Response · 200JSON
{
  "location_id": 7,
  "configured": false,
  "price_mode": "tax_exclusive",
  "lines": [
    {
      "order": 1,
      "name": "bay-01",
      "type": "percent",
      "rate": "string",
      "compound": false,
      "excluded_components": [
        "ENERGY"
      ],
      "registration_number": "string"
    }
  ],
  "preset": "string",
  "updated_by": "string",
  "updated_at": "2026-09-30T17:00:00Z"
}
Requires an approved production API keyProduction access starts with a request, a short meeting with Ivora and a card on file, after which Ivora staff grant your account access. How to request access
Try itproduction · api.ivoracharge.com

Paste a production api key (iv_live_…). Create keys in Developer tools. The key stays in this page's memory, is sent only to https://api.ivoracharge.com and clears when you reload. Test keys are refused.