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

#### URL Expired

The URL for this request expired after 30 days.

Start of the date-time-range of the nomination. The start date-time is inclusive. If left empty, defaults to returning current and future nominations.

**meter_ids**

array of uuids

length between 0 and 1000

Meter ID

**meter_ids**
ADD uuid

**start_time**  
date-time

Start of the date-time-range of the nomination. The start date-time is inclusive.

**end_time**  
date-time

End of the date-time-range of the nomination. The end date-time is exclusive. So for a nomination for the month of May, the start date-time would be '2025-05-01T08:00:00Z' and the end date-time would be '2025-06-01T08:00:00Z'.

If the end date-time is left empty, the nomination applies to all future date-times.

**program_identifier**

string

enum

Identifier of program

**CEC-DSGSCAISO-CCA-SC_ONLY**
**CCACEC-DSGS-OPTION4**
**CEC-DSGSCONED-CSRPCONED-DLRPDRAMELRPENERGY-ONLYERCOT-ERSEVERSOURCE-CSMA_DOER-CPSNATGRID-CSNRG-REALTIMENRG-REDNYISO-SCRONCOR-CLMPGE-ARTPGE-CBPPJM-CAPACITYPSEGLI-CSRPPSEGLI-DLRPRIE-CSUNITIL-CS**

Show 24 enum values

**updated_since**

date-time

Flag to search for entries update at or after the given date-time

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

**page_size**

int32

1 to 500

Defaults to 500

Amount of results to return. Defaults to 500.

**accept**

string

enum

Defaults to application/json

Generated from available response content types

**application/json**
**text/csv**

Allowed:

`application/json``text/csv`

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

**nominations**

array of objects

required

**nominations***

object

Start of the date-time-range of the nomination. The start date-time is inclusive. If left empty, defaults to returning current and future nominations.

**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_time**

date-time

Start of the date-time-range of the nomination. The start date-time is inclusive.

**end_time**

date-time

If the end date-time is left empty, the nomination applies to all future date-times.

**source**

string

enum

required

Source of the nomination; either Leap or a suggestion from the Partner.

`LEAP``PARTNER`

**nomination_kw**

double

required

0 to 10000

Nominated curtailable load for this meter in kilowatts. Precision of up to 2 decimal places.

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

*Updated 11 months ago*

---

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

**{
  "next_page_token": "next_page_token",
  "nominations": [
    {
      "start_time": "2025-05-01T08:00:00Z",
      "updated_at": "2025-06-01T08:00:00Z",
      "program_identifier": "CEC-DSGS",
      "end_time": "2025-06-01T08:00:00Z",
      "source": "LEAP",
      "nomination_kw": 1.23,
      "meter_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
    },
    {
      "start_time": "2025-05-01T08:00:00Z",
      "updated_at": "2025-06-01T08:00:00Z",
      "program_identifier": "CEC-DSGS",
      "end_time": "2025-06-01T08:00:00Z",
      "source": "LEAP",
      "nomination_kw": 1.23,
      "meter_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
    }
  ]
}**

*Updated 11 months ago*