Skip to content

List grid feeds

Request

List all grid feeds visible to the authenticated client. Grid feeds represent sources of grid signal data used for smart charging decisions.

Security
oauth2(Required scopes: grid:read)
Query
page_beforestring[a-z]{4}[A-Z\d]{26}

Return results from the page after this ID.

Example:page_before=xmpl01HNFZM7Q8FXASZXYZ6XM3TQRR
page_afterstring[a-z]{4}[A-Z\d]{26}

Return results from the page before this ID.

Example:page_after=xmpl01HNFZM7Q8FXASZXYZ6XM3TQRR
page_sizeinteger, [ 1 .. 100 ]

Specify the number of results to return per page.

Default:25
Example:page_size=10
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/grid_feeds?page_before=xmpl01HNFZM7Q8FXASZXYZ6XM3TQRR&page_after=xmpl01HNFZM7Q8FXASZXYZ6XM3TQRR&page_size=10' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'EvEnergy-Version: 2'

Responses

Returns a list of grid feeds, sorted by name.

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
Array [
idstringgrfd[A-Z\d]{26}read-onlyrequired

Unique identifier for the grid feed.

Example:"grfd01HN2NJ9NMRZBXT1H6FT9N7735"
urlstring, (uri)read-onlyrequired
Example:"https://api.ev.energy/v2/grid_feeds/grfd01HN2NJ9NMRZBXT1H6FT9N7735"
namestringread-onlyrequired

Human-readable name for the grid feed.

Example:"CAISO Peak Demand"
reference_codestringread-onlyrequired

Machine-readable reference code for the grid feed, consistent across environments.

Example:"CAISO_PEAK"
priorityinteger, [ 1 .. 10 ]read-onlyrequired

Priority level (1-10) used to resolve conflicts when a user has multiple overlapping grid feeds.

Example:8
]
Response
[
  {
    "id": "grfd01HN2NJ9NMRZBXT1H6FT9N7735",
    "url": "https://api.ev.energy/v2/grid_feeds/grfd01HN2NJ9NMRZBXT1H6FT9N7735",
    "name": "CAISO Peak Demand",
    "reference_code": "CAISO_PEAK",
    "priority": 8
  }
]