URL Expired

The URL for this request expired after 30 days.

Meter ID

uuid
required
Meter ID

Start Date

date
Start date of the window to look for nomination suggestions, defaults to beginning of this day. Any suggestion that is ending after this date is included.

End Date

date
End date of the window to look for nomination suggestions, defaults to null. Any suggestion that is starting at or before this date is included.

`200 Successful response returning all the affected suggestions.

object
suggestions array of objects
required
suggestions
object
nomination_suggestion_id uuid
required
Nomination Suggestion ID

meter_id uuid
required
Meter ID

program_identifier string
enum
required
Identifier of program

CAISO-CCA-SC_ONLY``CCA``CEC-DSGS-OPTION4``CEC-DSGS``CONED-CSRP``CONED-DLRP``DRAM``ELRP``ENERGY-ONLY``ERCOT-ERS``EVERSOURCE-CS``MA_DOER-CPS``NATGRID-CS``NRG-REALTIME``NRG-RED``NYISO-SCR``ONCOR-CLM``PGE-ART``PGE-CBP``PJM-CAPACITY``PSEGLI-CSRP``PSEGLI-DLRP``RIE-CS``UNITIL-CS

start_date date
required
Start of the date-range of the nomination suggestion.

end_date date
End of the date-range of the nomination suggestion. Should be greater than the start date.

The end date is exclusive. So to suggest a nomination for the month of May, the start date would be '2025-05-01' and the end date would be '2025-06-01'.

If the end date is left empty, we will assume the intended date-range is open-ended, and the nomination applies to all future dates.

nomination_kw
double
required
0 to 10000
Nominated curtailable load for this meter in kilowatts. Precision of up to 2 decimal places.

status string
enum
required
Status of the nomination suggestion

RECEIVED``APPROVED``MODIFIED``DENIED``DELETED

created_at
date-time
required
Date of creation

created_by
string
required
Username of the creator, or the api key.

updated_at
date-time
required
Notes the time of the last update to the item.

``400 The request is not valid

``401 You are not authorized to perform this operation.

``403 You do not have the necessary permissions for this operation.

``404 Meter not found

``500 Internal server error

Example Response

{
  "suggestions": [
    {
      "end_date": "2025-06-01",
      "updated_at": "2025-06-01T08:00:00Z",
      "program_identifier": "CEC-DSGS",
      "created_at": "2025-01-01T00:00:01Z",
      "nomination_suggestion_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "nomination_kw": 1.23,
      "meter_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "created_by": "created_by",
      "start_date": "2025-05-01",
      "status": "RECEIVED"
    },
    {
      "end_date": "2025-06-01",
      "updated_at": "2025-06-01T08:00:00Z",
      "program_identifier": "CEC-DSGS",
      "created_at": "2025-01-01T00:00:01Z",
      "nomination_suggestion_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "nomination_kw": 1.23,
      "meter_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "created_by": "created_by",
      "start_date": "2025-05-01",
      "status": "RECEIVED"
    }
  ]
}

Updated 11 months ago