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

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

{
  "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"
    }
  ]
}