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

#### URL Expired

The URL for this request expired after 30 days.

### meter_ids

- **Type**: array of uuids
- **Length**: between 0 and 1000

### Meter ID

**meter_ids**
ADD uuid

### start_date

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

### end_date

- **Type**: 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.

### status

- **Type**: string  
- **Enum**: Status of the nomination suggestion  
`RECEIVED`, `APPROVED`, `MODIFIED`, `DENIED`, `DELETED`

### program_identifier

- **Type**: string  
- **Enum**: Identifier of program  
`CEC-DSGS`, `CAISO-CCA-SC_ONLY`, `CCA`, `CEC-DSGS-OPTION4`, `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`

### updated_since

- **Type**: date-time  
Flag to search for entries updated at or after the given date-time

### page_token

- **Type**: string  
If there are more nominations to fetch, this token will be populated as `next_page_token` in the response. Use it to fetch the next page.

### page_size

- **Type**: int32  
1 to 500  
Defaults to 500  
Amount of results to return. Defaults to 500.

### accept

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

Allowed:  
`application/json`, `text/csv`

# Response Codes

## 200
Successful response returning all the matching suggestions.

### Object

- **next_page_token**: string  
If there are more nominations to fetch, this token will be populated as `next_page_token` in the response. Use it to fetch the next page.

- **suggestions**: array of objects  
  - **required**

### suggestions*

- **Nomination Suggestion ID**: uuid

### Required Fields

- **meter_id**: uuid  
- **program_identifier**: string  
  - **Enum**:  
`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  
- **end_date**: date  
- **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**:  
`RECEIVED`, `APPROVED`, `MODIFIED`, `DENIED`, `DELETED`
- **created_at**: date-time  
- **created_by**: string  
- **updated_at**: date-time

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

```bash
curl --request POST \
     --url https://api.staging.leap.energy/v2/meters/nominations/suggestions/search \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"page_size":500}'
```

### Example Response

```json
{
  "next_page_token": "next_page_token",
  "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"
    }
  ]
}
```