Skip to main content

​
Format

All error responses share this shape: 
{
  "error": {
    "code": "LOCATION_NOT_FOUND",
    "message": "Location 123 was not found for the provided tenant",
    "requestId": "b1f6e6b0-1234-4abc-9def-000000000000"
  }
}
requestId is unique per request — include it when contacting RiDERgy support about a specific error.

​
Error codes

CodeHTTP statusMeaning
UNAUTHORIZED401Missing, invalid, inactive, or expired API key.
FEATURE_NOT_ENABLED403The Energy Management API is not enabled for your tenant.
INVALID_REQUEST_BODY400The request body is missing required fields, malformed JSON, or fails validation (e.g. limitKw <= 0, endTime <= startTime, endTime in the past, priority outside 0–10).
TARGET_INACTIVE400The target location is marked inactive.
LOCATION_NOT_FOUND404No location with the given locationId exists for your tenant.
CHARGER_NOT_FOUND404No connector with the given controllerUuid/connectorId exists for your tenant.
CLUSTER_NOT_FOUND404No cluster with the given clusterId exists for your tenant.
CLUSTER_INACTIVE400The cluster’s status is INACTIVE.
CLUSTER_EMPTY400The cluster has no member locations.
NOT_FOUND404The path/method combination is not a valid endpoint.
INTERNAL_ERROR500Unexpected server-side error.