Easee Site Charge Session API

openapi: 3.2.0
info:
  title: Easee Cloud Site Charge Session API
  description: OpenAPI Definitions for Easee Cloud APIs.
  version: v1
servers:
- url: https://api.easee.com
security:
- Bearer: []
tags:
- name: Site Charge Session
  description: Energy usage, cost and sessions for a site.
  x-displayName: Site Charge Session
paths:
  /api/sessions/export/{siteId}/{category}/{from}/{to}:
    get:
      tags:
      - Site Charge Session
      summary: Site Consumption Report
      description: Get site consumption report.
      operationId: ChargeSession_ExportConsumption
      parameters:
      - name: siteId
        in: path
        required: true
        description: Site ID
        schema:
          type: string
        x-position: 1
      - name: category
        in: path
        required: true
        description: Report Type
        schema:
          $ref: '#/components/schemas/Easee_Cloud_API_ReportCategory'
        x-position: 2
      - name: from
        in: path
        required: true
        description: From (ISO8601 datetime)
        schema:
          type: string
          format: date-time
        x-position: 3
      - name: to
        in: path
        required: true
        description: To (ISO8601 datetime)
        schema:
          type: string
          format: date-time
        x-position: 4
      - name: chargerId
        in: query
        schema:
          type:
          - string
          - 'null'
        x-position: 5
      - name: rfidKeys
        in: query
        style: form
        explode: true
        schema:
          type:
          - array
          - 'null'
          items:
            type: string
        x-position: 6
      - name: tz
        in: query
        description: Timezone for example Europe/Oslo
        schema:
          type:
          - string
          - 'null'
        x-position: 7
      - name: reference
        in: query
        description: Report Reference
        schema:
          type:
          - string
          - 'null'
        x-position: 8
      responses:
        '200':
          description: Consumption Report
          content:
            application/octet-stream:
              schema:
                type: string
                format: binary
  /api/sites/{siteId}/breakdown/{from}/{to}:
    get:
      tags:
      - Site Charge Session
      summary: Usage/Cost - Breakdown
      description: Get power usage and cost for all chargers on a site in a time period. Rate limited at max 10 requests per 60 minutes.
      operationId: ChargingSessionsSite_GetChargeSessionBreakdownByUser
      parameters:
      - name: siteId
        in: path
        required: true
        description: Site Id
        schema:
          type: integer
          format: int32
        x-position: 1
      - name: from
        in: path
        required: true
        description: ISO8601 timestamp
        schema:
          type: string
          format: date-time
        x-position: 2
      - name: to
        in: path
        required: true
        description: ISO8601 timestamp
        schema:
          type: string
          format: date-time
        x-position: 3
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_ChargingSessionDetailDTO'
  /api/sites/{siteId}/daily:
    get:
      tags:
      - Site Charge Session
      summary: Usage/Cost - Daily
      description: Get daily power usage and cost for charging sessions on a site. Rate limited at max 10 requests per 60 minutes.
      operationId: ChargingSessionsSite_GetDailySummaryBySite
      parameters:
      - name: siteId
        in: path
        required: true
        description: Site Id
        schema:
          type: integer
          format: int32
        x-position: 1
      responses:
        '200':
          description: Daily summary
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_DailySummaryDTO'
  /api/sites/{siteId}/monthly:
    get:
      tags:
      - Site Charge Session
      summary: Usage/Cost - Monthly
      description: Get monthly power usage and cost for charging sessions on a site. Rate limited at max 10 requests per 60 minutes.
      operationId: ChargingSessionsSite_GetMonthlySummaryBySite
      parameters:
      - name: siteId
        in: path
        required: true
        description: Site Id
        schema:
          type: integer
          format: int32
        x-position: 1
      responses:
        '200':
          description: Monthly summary
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_MonthlySummaryDTO'
  /api/sites/{siteId}/weekly:
    get:
      tags:
      - Site Charge Session
      summary: Usage/Cost - Weekly
      description: Get weekly power usage and cost for charging sessions on a site. Rate limited at max 10 requests per 60 minutes.
      operationId: ChargingSessionsSite_GetWeeklySummaryBySite
      parameters:
      - name: siteId
        in: path
        required: true
        description: Site Id
        schema:
          type: integer
          format: int32
        x-position: 1
      responses:
        '200':
          description: Weekly summary
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_WeeklySummaryDTO'
  /api/sites/{siteId}/yearly:
    get:
      tags:
      - Site Charge Session
      summary: Usage/Cost - Yearly
      description: Get yearly power usage and cost for charging sessions on a site. Rate limited at max 10 requests per 60 minutes.
      operationId: ChargingSessionsSite_GetYearlySummaryBySite
      parameters:
      - name: siteId
        in: path
        required: true
        description: Site Id
        schema:
          type: integer
          format: int32
        x-position: 1
      responses:
        '200':
          description: Yearly summary
          content:
            application/json:
              schema:
                type: number
                format: double
        '404':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_ProblemDetails'
components:
  schemas:
    Easee.ChargeSessionTracking.WebApi_WeeklySummaryDTO:
      type: object
      additionalProperties: false
      properties:
        year:
          type: integer
          format: int32
        month:
          type: integer
          format: int32
        weekOfYear:
          type: integer
          format: int32
        totalEnergyUsage:
          type: number
          format: double
        totalCost:
          type: number
          format: double
        currencyId:
          type: string
        authTokensUsage:
          type: array
          items:
            $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_AuthorizationTokenEnergy'
    Easee.ChargeSessionTracking.WebApi_DailySummaryDTO:
      allOf:
      - $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_MonthlySummaryDTO'
      - type: object
        additionalProperties: false
        properties:
          dayOfMonth:
            type: integer
            format: int32
    Easee.ChargeSessionTracking.WebApi_AuthorizationTokenEnergy:
      type: object
      additionalProperties: false
      properties:
        rfidKey:
          type: string
        energy:
          type: number
          format: double
        authToken:
          type: string
    Easee_Cloud_API_ReportCategory:
      type: integer
      description: ''
      x-enumNames:
      - CSVUserSummeryReport
      - CSVUserDetailedReport
      - CSVChargerSummaryReport
      - CSVChargerDetailedReport
      - ExcelUserSummeryReport
      - ExcelUserDetailedReport
      - ExcelChargerSummaryReport
      - ExcelChargerDetailedReport
      - PDFUserSummeryReport
      - PDFUserDetailedReport
      - PDFChargerSummaryReport
      - PDFChargerDetailedReport
      - PDFEaseeKeySummaryReport
      - PDFEaseeKeyDetailedReport
      - CSVEaseeKeySummaryReport
      - CSVEaseeKeyDetailedReport
      - ExcelEaseeKeySummaryReport
      - ExcelEaseeKeyDetailedReport
      - CSVEnergySummeryReport
      - PDFEnergySummeryReport
      - ExcelEnergySummeryReport
      enum:
      - 0
      - 1
      - 2
      - 3
      - 4
      - 5
      - 6
      - 7
      - 8
      - 9
      - 10
      - 11
      - 12
      - 13
      - 14
      - 15
      - 16
      - 17
      - 18
      - 19
      - 20
    Easee.ChargeSessionTracking.WebApi_ProblemDetails:
      type: object
      additionalProperties: {}
      properties:
        type:
          type:
          - string
          - 'null'
        title:
          type:
          - string
          - 'null'
        status:
          type:
          - integer
          - 'null'
          format: int32
        detail:
          type:
          - string
          - 'null'
        instance:
          type:
          - string
          - 'null'
    Easee.ChargeSessionTracking.WebApi_MonthlySummaryDTO:
      type: object
      additionalProperties: false
      properties:
        year:
          type: integer
          format: int32
        month:
          type: integer
          format: int32
        totalEnergyUsage:
          type: number
          format: double
        totalCost:
          type: number
          format: double
        currencyId:
          type: string
        authTokensUsage:
          type: array
          items:
            $ref: '#/components/schemas/Easee.ChargeSessionTracking.WebApi_AuthorizationTokenEnergy'
    Easee.ChargeSessionTracking.WebApi_ChargingSessionDetailDTO:
      type: object
      additionalProperties: false
      properties:
        chargerId:
          type: string
        chargerName:
          type: string
        totalEnergyUsage:
          type: number
          format: double
        totalCost:
          type: number
          format: double
        currencyId:
          type: string
  securitySchemes:
    Bearer:
      type: apiKey
      description: 'JWT Authorization header using the Bearer scheme. Example: "Authorization: Bearer {token}"'
      name: Authorization
      in: header
x-provenance:
  method: searched
  source: https://developer.easee.com/reference
  harvested: '2026-10-27'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer.easee.com/reference/account_addchargerfavoritebypin.md
  - https://developer.easee.com/reference/account_authenticate.md
  - https://developer.easee.com/reference/account_getchargerfavorites.md
  - https://developer.easee.com/reference/account_getfavorites.md
  - https://developer.easee.com/reference/account_getproductfavorites.md
  - https://developer.easee.com/reference/account_getprofile.md
  - https://developer.easee.com/reference/account_invalidatetoken.md
  - https://developer.easee.com/reference/account_refreshtoken.md
  - https://developer.easee.com/reference/account_removechargerfavorite.md
  - https://developer.easee.com/reference/applyocppforchargerendpoint.md
  - https://developer.easee.com/reference/applyocppforsiteendpoint.md
  - https://developer.easee.com/reference/applyocppforuserchargerendpoint.md
  - https://developer.easee.com/reference/authorizecharging_startcharging.md
  - https://developer.easee.com/reference/charger_acceptchargerinvitationlink.md
  - https://developer.easee.com/reference/charger_addchargeplan.md
  - https://developer.easee.com/reference/charger_addchargertoaccount.md
  - https://developer.easee.com/reference/charger_addweeklychargeschedule.md
  - https://developer.easee.com/reference/charger_createchargerinvitationlink.md
  - https://developer.easee.com/reference/charger_deletechargeplan.md
  - https://developer.easee.com/reference/charger_deleteuserchargeraccess.md
  - https://developer.easee.com/reference/charger_deleteweeklychargeschedule.md
  - https://developer.easee.com/reference/charger_enable_smart_charging.md
  - https://developer.easee.com/reference/charger_getall.md
  - https://developer.easee.com/reference/charger_getcachedchargerconfig.md
  - https://developer.easee.com/reference/charger_getchargeplan.md
  - https://developer.easee.com/reference/charger_getchargerbyid.md
  - https://developer.easee.com/reference/charger_getchargerdetails.md
  - https://developer.easee.com/reference/charger_getchargerinvitationpreview.md
  - https://developer.easee.com/reference/charger_getchargeroperator.md
  - https://developer.easee.com/reference/charger_getchargersite.md
  - https://developer.easee.com/reference/charger_getchargerusers.md
  - https://developer.easee.com/reference/charger_gethourlyaggregatedusage.md
  - https://developer.easee.com/reference/charger_getweeklychargeschedule.md
  - https://developer.easee.com/reference/charger_linkcharger.md
  - https://developer.easee.com/reference/charger_overrideschedule.md
  - https://developer.easee.com/reference/charger_pair_rfid_tag.md
  - https://developer.easee.com/reference/charger_pausesession.md
  - https://developer.easee.com/reference/charger_reboot.md
  - https://developer.easee.com/reference/charger_removechargerfromaccount.md
  - https://developer.easee.com/reference/charger_removechargerinvitationlink.md
  - https://developer.easee.com/reference/charger_removechargeroperator.md
  - https://developer.easee.com/reference/charger_resendchargerinvitationlink.md
  - https://developer.easee.com/reference/charger_resumesession.md
  - https://developer.easee.com/reference/charger_scan_wifi.md
  - https://developer.easee.com/reference/charger_set_cable_lock_state.md
  - https://developer.easee.com/reference/charger_set_dynamic_charger_current.md
  - https://developer.easee.com/reference/charger_set_phase_mode.md
  - https://developer.easee.com/reference/charger_set_wifi_configuration.md
  - https://developer.easee.com/reference/charger_setchargeraccesslevel.md
  - https://developer.easee.com/reference/charger_setchargersetting.md
  - https://developer.easee.com/reference/charger_setchargeschedulefeatures.md
  - https://developer.easee.com/reference/charger_setoperator.md
  - https://developer.easee.com/reference/charger_stop_charging.md
  - https://developer.easee.com/reference/charger_togglecharging.md
  - https://developer.easee.com/reference/charger_update_firmware.md
  - https://developer.easee.com/reference/chargers_deletechargingsession.md
  - https://developer.easee.com/reference/chargers_getlastupdatedchargesession.md
  - https://developer.easee.com/reference/chargers_getongoingsessiondetails.md
  - https://developer.easee.com/reference/chargesession_exportconsumption.md
  - https://developer.easee.com/reference/chargingsessionscharger_getchargersessionsbycharger.md
  - https://developer.easee.com/reference/chargingsessionscharger_getdailysummarybycharger.md
  - https://developer.easee.com/reference/chargingsessionscharger_gethourlysummarybycharger.md
  - https://developer.easee.com/reference/chargingsessionscharger_getlimitchargersessionsbycharger.md
  - https://developer.easee.com/reference/chargingsessionscharger_getmonthlysummarybycharger.md
  - https://developer.easee.com/reference/chargingsessionscharger_gettotalkwhamountbycharger.md
  - https://developer.easee.com/reference/chargingsessionscharger_getyearlysummarybycharger.md
  - https://developer.easee.com/reference/chargingsessionssite_getchargesessionbreakdownbyuser.md
  - https://developer.easee.com/reference/chargingsessionssite_getdailysummarybysite.md
  - https://developer.easee.com/reference/chargingsessionssite_getmonthlysummarybysite.md
  - https://developer.easee.com/reference/chargingsessionssite_getweeklysummarybysite.md
  - https://developer.easee.com/reference/chargingsessionssite_getyearlysummarybysite.md
  - https://developer.easee.com/reference/chargingsessionsuser_getchargersessionsbyuser.md
  - https://developer.easee.com/reference/chargingsessionsuser_getchargesessionbreakdownbyuser.md
  - https://developer.easee.com/reference/chargingsessionsuser_getmonthlysummarybyuser.md
  - https://developer.easee.com/reference/chargingsessionsuser_gettotalkwhamountbyuser.md
  - https://developer.easee.com/reference/chargingsessionsuser_getweeklysummarybyuser.md
  - https://developer.easee.com/reference/chargingsessionsuser_getyearlysummarybyuser.md
  - https://developer.easee.com/reference/deletechargersschedulesdaily.md
  - https://developer.easee.com/reference/deletechargersschedulesdelayed.md
  - https://developer.easee.com/reference/deletechargersschedulesweekly.md
  - https://developer.easee.com/reference/disableocppforchargerendpoint.md
  - https://developer.easee.com/reference/disableocppforuserchargerendpoint.md
  - https://developer.easee.com/reference/easeekeys_addeaseekey.md
  - https://developer.easee.com/reference/easeekeys_deleteeaseekey.md
  - https://developer.easee.com/reference/easeekeys_geteaseekeys.md
  - https://developer.easee.com/reference/easeekeys_updateeaseekey.md
  - https://developer.easee.com/reference/equalizer_configureallocatedcurrent.md
  - https://developer.easee.com/reference/equalizer_configuremetertype.md
  - https://developer.easee.com/reference/equalizer_geequalizerconfig.md
  - https://developer.easee.com/reference/equalizer_getdetailedequalizer.md
  - https://developer.easee.com/reference/equalizer_getequalizer.md
  - https://developer.easee.com/reference/equalizer_getequalizersite.md
  - https://developer.easee.com/reference/equalizer_reboot.md
  - https://developer.easee.com/reference/equalizer_updatefirmware.md
  - https://developer.easee.com/reference/getchargerconnectiondetailsendpoint.md
  - https://developer.easee.com/reference/getchargersschedules.md
  - https://developer.easee.com/reference/getchargersschedulesdaily.md
  - https://developer.easee.com/reference/getchargersschedulesdelayed.md
  - https://developer.easee.com/reference/getchargersschedulesweekly.md
  - https://developer.easee.com/reference/getobservations.md
  - https://developer.easee.com/reference/getoperatorconnectiondetailsendpoint.md
  - https://developer.easee.com/reference/getuserchargerconnectiondetailsendpoint.md
  - https://developer.easee.com/reference/getworkflowresultsendpoint.md
  - https://developer.easee.com/reference/getworkflowstreamendpoint.md
  - https://developer.easee.com/reference/lifetimeenergyreporting_configure.md
  - https://developer.easee.com/reference/lifetimeenergyreporting_getchargerbyid.md
  - https://developer.easee.com/reference/lifetimeenergyreporting_getdailyforperiod.md
  - https://developer.easee.com/reference/lifetimeenergyreporting_gethourlyforperiod.md
  - https://developer.easee.com/reference/lifetimeenergyreporting_getmonthlyforperiod.md
  - https://developer.easee.com/reference/lifetimeenergyreporting_getyearlyforperiod.md
  - https://developer.easee.com/reference/partners_deletecustomendpoint.md
  - https://developer.easee.com/reference/partners_getallcustomendpoints.md
  - https://developer.easee.com/reference/partners_getcustomendpointsonsite.md
  - https://developer.easee.com/reference/partners_getocppconfig.md
  - https://developer.easee.com/reference/partners_saveocppconfig.md
  - https://developer.easee.com/reference/partners_setcustomendpoint.md
  - https://developer.easee.com/reference/postchargerconnectiondetailsendpoint.md
  - https://developer.easee.com/reference/postchargersschedulesdaily.md
  - https://developer.easee.com/reference/postchargersschedulesdailydisable.md
  - https://developer.easee.com/reference/postchargersschedulesdailyenable.md
  - https://developer.easee.com/reference/postchargersschedulesdelayed.md
  - https://developer.easee.com/reference/postchargersschedulesdelayeddisable.md
  - https://developer.easee.com/reference/postchargersschedulesdelayedenable.md
  - https://developer.easee.com/reference/postchargersschedulesweekly.md
  - https://developer.easee.com/reference/postchargersschedulesweeklydisable.md
  - https://developer.easee.com/reference/postchargersschedulesweeklyenable.md
  - https://developer.easee.com/reference/postoperatorconnectiondetailsendpoint.md
  - https://developer.easee.com/reference/postuserchargerconnectiondetailsendpoint.md
  - https://developer.easee.com/reference/resources_getactivecountries.md
  - https://developer.easee.com/reference/resources_getallcountries.md
  - https://developer.easee.com/reference/resources_getcurrencies.md
  - https://developer.easee.com/reference/resources_getobservationproperties.md
  - https://developer.easee.com/reference/site_acceptsiteinvitationlink.md
  - https://developer.easee.com/reference/site_attachchargerstobackplates.md
  - https://developer.easee.com/reference/site_createsiteinvitationlink.md
  - https://developer.easee.com/reference/site_deleteaccesslevelforchargers.md
  - https://developer.easee.com/reference/site_deletecircuit.md
  - https://developer.easee.com/reference/site_deletesite.md
  - https://developer.easee.com/reference/site_deletesiteinvitation.md
  - https://developer.easee.com/reference/site_deletesitepermission.md
  - https://developer.easee.com/reference/site_deletesiteuser.md
  - https://developer.easee.com/reference/site_disablecontrolaccess.md
  - https://developer.easee.com/reference/site_getall.md
  - https://developer.easee.com/reference/site_getchargerenergybysite.md
  - https://developer.easee.com/reference/site_getchargers.md
  - https://developer.easee.com/reference/site_getcircuitattachedsite.md
  - https://developer.easee.com/reference/site_getcircuitsettings.md
  - https://developer.easee.com/reference/site_getdynamiccircuitcurrent.md
  - https://developer.easee.com/reference/site_geteaseecontroluiaccessrequest.md
  - https://developer.easee.com/reference/site_getmonthlyconsumptionbyuser.md
  - https://developer.easee.com/reference/site_getmonthlyconsumptionbyuserandcharger.md
  - https://developer.easee.com/reference/site_getsitebyid.md
  - https://developer.easee.com/reference/site_getsiteinvitationpreview.md
  - https://developer.easee.com/reference/site_getsitestate.md
  - https://developer.easee.com/reference/site_getsiteusers.md
  - https://developer.easee.com/reference/site_getyearlyconsumptionbyuser.md
  - https://developer.easee.com/reference/site_getyearlyconsumptionbyuserandcharger.md
  - https://developer.easee.com/reference/site_removeequalizerfromsite.md
  - https://developer.easee.com/reference/site_requestcontrolaccess.md
  - https://developer.easee.com/reference/site_requestsiteaccess.md
  - https://developer.easee.com/reference/site_resendsiteinvitationlink.md
  - https://developer.easee.com/reference/site_savechargingprice.md
  - https://developer.easee.com/reference/site_setaccesslevel.md
  - https://developer.easee.com/reference/site_setaccesslevelforchargers.md
  - https://developer.easee.com/reference/site_setcircuit.md
  - https://developer.easee.com/reference/site_setcircuitmaster.md
  - https://developer.easee.com/reference/site_setcircuitsettings.md
  - https://developer.easee.com/reference/site_setdynamiccircuitcurrent.md
  - https://developer.easee.com/reference/site_setsiteowner.md
  - https://developer.easee.com/reference/site_updatechargers.md
  - https://developer.easee.com/reference/site_updatecircuitcollection.md
  - https://developer.easee.com/reference/site_updatecircuits.md
  - https://developer.easee.com/reference/site_updatesitepatch.md
  - https://developer.easee.com/reference/site_updatesitepermission.md
  - https://developer.easee.com/reference/siteintegration_setaccesslevel.md
  merge:
    pages: 175
    deduped: 474
    conflicts_kept_first: 0