Getting an Event

Get a specifc Event.

HTTP Request

GET https://utilityapi.com/api/v2/events/event_uid

Examples

# Get a Event
curl -H 'Authorization: Bearer API_TOKEN_HERE' \
    'https://utilityapi.com/api/v2/events/1234'

Query Parameters

None

Response

Returns the Event object.

// Example result
{
    "uid": "12345",
    "type": "meter_historical_collection_finished_successful",
    "ts": "2016-01-01T12:30:24.653422+00:00",
    "is_delivered": false,
    "authorization_uid": "12345-62222",
    "meter_uid": "12345-6"
}

HTTP Response Codes

Code	Response Format	Description
`200`	Event	Successful request.
`401`	Error	Invalid or missing `access_token`. See our docs on Authentication for how to properly use your `access_token`.
`404`	Error	This Event doesn't exist or you don't have permissions to see it.
`429`	N/A	The request was rate limited. Check the `Retry-After` response header for how long to wait until retrying the request. Do not expect any specific response format for this error (could be html, json, or nothing).
`500`	N/A	Internal server error. Do not expect any specific response format for this error (could be html, json, or nothing). This error is logged and will be fixed by our engineers.
`503`	N/A	Site is currently down for maintenance. Do not expect any specific response format for this error (could be html, json, or nothing).
`504`	N/A	We tried to build this request but timed out. Please try again later. Do not expect any specific response format for this error (could be html, json, or nothing).