| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### 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

```json
{
  "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