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

#### URL Expired

The URL for this request expired after 30 days.

### object

#### program_identifier

**Type**: string  
**Enum**:  
Identifier of program  
- CEC-DSGSCAISO-CCA-SC_ONLY  
- 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

**Type**: date  
**Required**: Yes  
Start of the date-range of the nomination suggestion.

#### end_date

**Type**: date  
**Required**: Yes  
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

**Type**: double  
**Required**: Yes  
0 to 10000  
Nominated curtailable load for this meter in kilowatts. Precision of up to 2 decimal places.

#### meter_ids

**Type**: array of uuids  
**Required**: Yes  
Length between 0 and 1000  
Meter ID

#### meter_ids*

- ADD uuid
   
#### content-type

**Type**: string  
**Enum**:  
Defaults to application/json  
Generated from available request content types  
- application/json  
- text/csv

#### Allowed:

- `application/json`
- `text/csv`

### Response Codes

- `200`      Successful response returning all the affected suggestions.
- `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"
    }
  ]
}