Skip to content
/
Retrieve a status log for...

Retrieve a status log for a boundary meter

Request

A boundary meter status log is uniquely identified by the combination of boundary meter ID and the time it was sampled at.

Security
oauth2(Required scopes: boundary_meter:read)
Path
boundary_meter_idstringrequired

The ID of the specific Boundary Meter.

sampled_atstring, (date-time)required

The time the log's data was recorded on the device.

Example:2024-04-17T09:39:45.984584Z
Query
expandArray of strings

Specify a url field to expand into a nested resource.

Items Enum:"boundary_meter""boundary_meter.model""boundary_meter.model.make"
Headers
EvEnergy-Versionnumber

Specify the version of this endpoint to use.

Value:2
curl -i -X GET \
  'https://developers.ev.energy/_mock/ev.energy-api-v2/boundary_meters/{boundary_meter_id}/status_logs/2024-04-17T09:39:45.984584Z?expand=boundary_meter' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'EvEnergy-Version: 2'

Responses

Retrieve a single status log for a specific boundary meter.

Headers
EvEnergy-Versionnumber

Indicates the version of the API that generated this response. If EvEnergy-Version was not specified in the request, this will be your OAuth application's default version.

Value:2
X-RateLimit-Limitnumber

The maximum number of requests that can be made to this endpoint per hour. Defaults to 1000 but may vary per client.

Default:1000
X-RateLimit-Remainingnumber

The number of requests remaining until this client's rate limit is reached.

Default:999
RetryAfternumber

The number of seconds until this client's requests will not be rate limited.

Default:3600
Bodyapplication/json
urlstring, (uri)
Example:"https://api.ev.energy/v2/boundary_meters/bmet01J5DCXX8DMJDJYGVR1DW4T001/status_logs/2024-04-17T09:39:45.984584Z/"
sampled_atstring, (date-time)
boundary_meterBoundaryMeter (object) or string
One of:

A resource that represents a single, physical boundary meter.

power_wattsinteger or null

Instantaneous power at the meter in W. Positive = import, negative = export.

Example:1500
statusstringread-only

Derived operating state, inferred from power_watts.

Enum:"IMPORTING""EXPORTING""IDLE""UNKNOWN"
Example:"IMPORTING"
Response
{
  "url": "https://api.ev.energy/v2/boundary_meters/bmet01J5DCXX8DMJDJYGVR1DW4T001/status_logs/2024-04-17T09:39:45.984584Z/",
  "sampled_at": "2019-08-24T14:15:22Z",
  "boundary_meter": {
    "id": "bmet01J5DCXX8DMJDJYGVR1DW4T001",
    "url": "https://api.ev.energy/v2/boundary_meters/bmet01J5DCXX8DMJDJYGVR1DW4T001",
    "model": "https://api.ev.energy/v2/boundary_meter_models/bmmo01J5DCXX8DMJDJYGVR1DW4D001",
    "created_at": "2024-01-10T12:00:00Z",
    "latest_status_log": { … }
  },
  "power_watts": 1500,
  "status": "IMPORTING"
}