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