List tenant bills

get/v1/tenants/{tenant_id}/bills

Requires an API key

Repository snapshots without usage observation, ordered by opaque bill ID. Filter by station_id and status. Read one bill for its live usage.

Path parameters

tenant_idintegerRequired

Query parameters

station_idinteger | null
Greater than 0
statusenum | null
One of open, final
afterstring
Default "" · Up to 40 characters
limitinteger
Default 50 · Minimum 1 · Maximum 100

Returns · 200

dataarray of BillRecordRequired
Child attributes
- idstringRequired
- tenant_idintegerRequired
- station_idintegerRequired
- connector_idintegerRequired
- sourceenumRequired
  One of csms, simulated
- tariff_idintegerRequired
- rate_minorstringRequired
- hold_minorintegerRequired
- currencystringRequired
- charging_tokenstringRequired
- statusenumRequired
  One of open, final
- energy_kwhstring | nullRequired
- energy_whinteger | null
  Integer Wh of the finalized usage.
- total_minorinteger | nullRequired
- transaction_idinteger | nullRequired
- created_atstringRequired
- finalized_atstring | nullRequired
- settlement_ownerenum
  One of managed, external · Default "managed"
- billing_versionstring
  Default "energy-v1"
- usageobject | null
  Single bill reads only: live matched usage after start, a final snapshot once final.
  Child attributes
  - transaction_idinteger | nullRequired
    Physical transaction resource ID; null for simulated bills.
  - activebooleanRequired
  - energy_kwhstring | nullRequired
    Decimal kWh string for display.
  - energy_whinteger | nullRequired
    Integer Wh for arithmetic.
  - estimated_minorinteger | nullRequired
    Integer minor units. On final bills this equals total_minor.
  - started_atstring | nullRequired
  - ended_atstring | nullRequired
  - power_winteger | null
    Latest reported charging power in watts; 0 once the transaction ended; null when the charger reports none.
  - soc_percentinteger | null
    Latest reported vehicle state of charge, when the charger reports it.
  - metered_atstring | null
    Timestamp of the meter sample behind power_w/soc_percent.
- start_operationobject | null
  Single bill reads only: the journaled start dispatch, if any.
  Child attributes
  - idstringRequired
  - tenant_idintegerRequired
  - statusenumRequired
    One of dispatching, succeeded, rejected, unknown
  - resultobject | nullRequired
  - created_atstringRequired
  - updated_atstringRequired
next_cursorstring | nullRequired

Errors

401 Unauthorized 403 Forbidden 404 Not found 409 Conflict 422 Invalid request 429 Rate limited 502 Upstream error 503 Unavailable

GET /v1/tenants/{tenant_id}/bills

curl --fail-with-body "https://api.ivoracharge.com/v1/tenants/1042/bills" \
  -H "Authorization: Bearer $IVORA_API_KEY"

Response · 200

{
  "data": [
    {
      "id": "id_0123456789abcdef",
      "tenant_id": 1042,
      "station_id": 1,
      "connector_id": 1,
      "source": "csms",
      "tariff_id": 42,
      "rate_minor": "string",
      "hold_minor": 1250,
      "currency": "USD",
      "charging_token": "string",
      "status": "open",
      "energy_kwh": "string",
      "energy_wh": 7500,
      "total_minor": 1250,
      "transaction_id": 1,
      "created_at": "2026-09-30T17:00:00Z",
      "finalized_at": "2026-09-30T17:00:00Z",
      "settlement_owner": "managed",
      "billing_version": "energy-v1",
      "usage": {
        "transaction_id": 1,
        "active": false,
        "energy_kwh": "string",
        "energy_wh": 7500,
        "estimated_minor": 1250,
        "started_at": "2026-09-30T17:00:00Z",
        "ended_at": "2026-09-30T17:00:00Z",
        "power_w": 1,
        "soc_percent": 1,
        "metered_at": "2026-09-30T17:00:00Z"
      },
      "start_operation": {
        "id": "id_0123456789abcdef",
        "tenant_id": 1042,
        "status": "dispatching",
        "result": {},
        "created_at": "2026-09-30T17:00:00Z",
        "updated_at": "2026-09-30T17:00:00Z"
      }
    }
  ],
  "next_cursor": "string"
}

Try it is not available here yetRequests from this page are off until the production API at https://api.ivoracharge.com is public. Use the code samples from your application server; Ivora grants production access. Keys are created in Developer tools.