---
updatedAt: 2025-08-27T20:58:53.000Z
agentTools:
  projectIndex: https://developer.leap.energy/llms.txt
---

# Suggest bulk nominations

Suggest nominations for multiple meters. A suggestion is reviewed by Leap before it becomes an actual nomination. Leap can approve, modify, or deny each suggestion. Modified suggestions are adjusted by Leap before becoming a nomination and will often include communication or coordination with your operations team.  Note that when a more recent suggestion completely eclipses an earlier provided suggestion, the earlier nomination will be deleted.  However, if there are partial overlaps, Leap will not automatically adjust or deduplicate these.  Use the 'Delete suggested nominations' endpoint to remove no longer needed suggestions.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "description": "API to retrieve and suggest nominations.",
    "title": "Meter Nomination API",
    "version": "2.0.0"
  },
  "servers": [
    {
      "description": "Leap staging API",
      "url": "https://api.staging.leap.energy"
    },
    {
      "description": "Leap production API",
      "url": "https://api.leap.energy"
    }
  ],
  "security": [
    {
      "Bearer": []
    }
  ],
  "tags": [
    {
      "name": "nominations"
    }
  ],
  "paths": {
    "/v2/meters/nominations/suggestions": {
      "post": {
        "description": "Suggest nominations for multiple meters. A suggestion is reviewed by Leap before it becomes an actual nomination. Leap can approve, modify, or deny each suggestion. Modified suggestions are adjusted by Leap before becoming a nomination and will often include communication or coordination with your operations team.  Note that when a more recent suggestion completely eclipses an earlier provided suggestion, the earlier nomination will be deleted.  However, if there are partial overlaps, Leap will not automatically adjust or deduplicate these.  Use the 'Delete suggested nominations' endpoint to remove no longer needed suggestions.",
        "operationId": "postNominationSuggestions",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "items": {
                  "$ref": "#/components/schemas/postNominationSuggestions_request_inner"
                },
                "maxItems": 10000,
                "minItems": 1,
                "type": "array"
              }
            },
            "text/csv": {
              "example": [
                "meter_id,program_identifier,start_date,end_date,nomination_kw",
                "963e4538-1312-425c-ab0b-f3da6cf75ad5,CCA,2025-09-01,2025-10-01,0.23",
                "362e9ece-62ef-4d32-a70e-6542cf5d30fc,CCA,2025-09-01,,15.0"
              ],
              "schema": {
                "items": {
                  "$ref": "#/components/schemas/postNominationSuggestions_request_inner_1"
                },
                "type": "array"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/getMeterNominationSuggestions_200_response"
                }
              }
            },
            "description": "Successful response returning all the affected suggestions."
          },
          "400": {
            "content": {
              "application/json": {
                "examples": {
                  "Meter id is not a UUID": {
                    "value": {
                      "title": "Meter id is not a UUID",
                      "status": 400,
                      "details": {
                        "meter_id": "abcdef"
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/getMeterNominationSuggestions_400_response"
                }
              }
            },
            "description": "The request is not valid"
          },
          "401": {
            "content": {
              "application/json": {
                "examples": {
                  "Unauthorized": {
                    "value": {
                      "title": "Unauthorized",
                      "status": 401,
                      "details": {}
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/getMeterNominationSuggestions_400_response"
                }
              }
            },
            "description": "You are not authorized to perform this operation."
          },
          "403": {
            "content": {
              "application/json": {
                "examples": {
                  "Forbidden": {
                    "value": {
                      "title": "You do not have the necessary permissions for this operation",
                      "status": 403,
                      "details": {}
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/getMeterNominationSuggestions_400_response"
                }
              }
            },
            "description": "You do not have the necessary permissions for this operation."
          },
          "404": {
            "content": {
              "application/json": {
                "examples": {
                  "Meter not found": {
                    "value": {
                      "title": "Meter not found",
                      "status": 404,
                      "details": {
                        "meter_id": "f5c5e328-e325-4d6d-b357-5015ed5962a7"
                      }
                    }
                  }
                },
                "schema": {
                  "$ref": "#/components/schemas/getMeterNominationSuggestions_400_response"
                }
              }
            },
            "description": "Meter not found"
          },
          "500": {
            "content": {
              "application/json": {
                "examples": {
                  "Internal Error": {
                    "value": "An error happened whilst processing your request"
                  }
                },
                "schema": {
                  "type": "string"
                }
              }
            },
            "description": "Internal server error"
          }
        },
        "summary": "Suggest bulk nominations",
        "tags": [
          "nominations"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "getMeterNominationSuggestions_400_response": {
        "example": {
          "details": {
            "error": "Meter id is not a UUID"
          },
          "title": "Bad Request",
          "status": 400
        },
        "properties": {
          "title": {
            "description": "Summary of what went wrong",
            "example": "Bad Request",
            "maxLength": 2000,
            "minLength": 1,
            "type": "string"
          },
          "status": {
            "description": "An error code indicating what went wrong, usually the same as the HTTP Status Code",
            "example": 400,
            "type": "integer"
          },
          "details": {
            "description": "Extra information about the error.",
            "example": {
              "error": "Meter id is not a UUID"
            },
            "type": "object"
          }
        }
      },
      "postNominationSuggestions_request_inner": {
        "allOf": [
          {
            "properties": {
              "program_identifier": {
                "description": "Identifier of program",
                "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"
                ],
                "example": "CEC-DSGS",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "start_date": {
                "description": "Start of the date-range of the nomination suggestion.",
                "example": "2025-05-01",
                "format": "date",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "end_date": {
                "description": "End of the date-range of the nomination suggestion. Should be greater than the start date.\nThe 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'.\nIf the end date is left empty, we will assume the intended date-range is open-ended, and the nomination  applies to all future dates.",
                "example": "2025-06-01",
                "format": "date",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "nomination_kw": {
                "description": "Nominated curtailable load for this meter in kilowatts. Precision of up to 2 decimal places.",
                "example": 1.23,
                "format": "double",
                "maximum": 10000,
                "minimum": 0,
                "type": "number"
              }
            },
            "required": [
              "nomination_kw"
            ]
          },
          {
            "properties": {
              "meter_ids": {
                "description": "Meter ID",
                "items": {
                  "format": "uuid",
                  "type": "string"
                },
                "maxItems": 1000,
                "minItems": 0,
                "type": "array",
                "uniqueItems": true
              }
            },
            "required": [
              "meter_ids"
            ]
          }
        ],
        "example": {
          "end_date": "2025-06-01",
          "program_identifier": "CEC-DSGS",
          "nomination_kw": 1.23,
          "meter_ids": [
            "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
            "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
            "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
            "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
            "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
          ],
          "start_date": "2025-05-01"
        },
        "required": [
          "meter_ids",
          "nomination_kw",
          "start_date"
        ]
      },
      "getMeterNominationSuggestions_200_response": {
        "example": {
          "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"
            }
          ]
        },
        "properties": {
          "suggestions": {
            "items": {
              "$ref": "#/components/schemas/getMeterNominationSuggestions_200_response_suggestions_inner"
            },
            "type": "array"
          }
        },
        "required": [
          "suggestions"
        ]
      },
      "getMeterNominationSuggestions_200_response_suggestions_inner": {
        "allOf": [
          {
            "properties": {
              "nomination_suggestion_id": {
                "description": "Nomination Suggestion ID",
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "nomination_suggestion_id"
            ]
          },
          {
            "properties": {
              "meter_id": {
                "description": "Meter ID",
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "meter_id"
            ]
          },
          {
            "properties": {
              "program_identifier": {
                "description": "Identifier of program",
                "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"
                ],
                "example": "CEC-DSGS",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "start_date": {
                "description": "Start of the date-range of the nomination suggestion.",
                "example": "2025-05-01",
                "format": "date",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "end_date": {
                "description": "End of the date-range of the nomination suggestion. Should be greater than the start date.\nThe 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'.\nIf the end date is left empty, we will assume the intended date-range is open-ended, and the nomination  applies to all future dates.",
                "example": "2025-06-01",
                "format": "date",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "nomination_kw": {
                "description": "Nominated curtailable load for this meter in kilowatts. Precision of up to 2 decimal places.",
                "example": 1.23,
                "format": "double",
                "maximum": 10000,
                "minimum": 0,
                "type": "number"
              }
            },
            "required": [
              "nomination_kw"
            ]
          },
          {
            "properties": {
              "status": {
                "description": "Status of the nomination suggestion",
                "enum": [
                  "RECEIVED",
                  "APPROVED",
                  "MODIFIED",
                  "DENIED",
                  "DELETED"
                ],
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "created_at": {
                "description": "Date of creation",
                "example": "2025-01-01T00:00:01Z",
                "format": "date-time",
                "type": "string"
              }
            },
            "required": [
              "created_at"
            ]
          },
          {
            "properties": {
              "created_by": {
                "description": "Username of the creator, or the api key.",
                "type": "string"
              }
            },
            "required": [
              "created_by"
            ]
          },
          {
            "properties": {
              "updated_at": {
                "description": "Notes the time of the last update to the item.",
                "example": "2025-06-01T08:00:00Z",
                "format": "date-time",
                "type": "string"
              }
            }
          }
        ],
        "example": {
          "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"
        },
        "required": [
          "created_at",
          "created_by",
          "meter_id",
          "nomination_kw",
          "nomination_suggestion_id",
          "program_identifier",
          "start_date",
          "status",
          "updated_at"
        ]
      },
      "postNominationSuggestions_request_inner_1": {
        "allOf": [
          {
            "properties": {
              "program_identifier": {
                "description": "Identifier of program",
                "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"
                ],
                "example": "CEC-DSGS",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "start_date": {
                "description": "Start of the date-range of the nomination suggestion.",
                "example": "2025-05-01",
                "format": "date",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "end_date": {
                "description": "End of the date-range of the nomination suggestion. Should be greater than the start date.\nThe 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'.\nIf the end date is left empty, we will assume the intended date-range is open-ended, and the nomination  applies to all future dates.",
                "example": "2025-06-01",
                "format": "date",
                "type": "string"
              }
            }
          },
          {
            "properties": {
              "nomination_kw": {
                "description": "Nominated curtailable load for this meter in kilowatts. Precision of up to 2 decimal places.",
                "example": 1.23,
                "format": "double",
                "maximum": 10000,
                "minimum": 0,
                "type": "number"
              }
            },
            "required": [
              "nomination_kw"
            ]
          },
          {
            "properties": {
              "meter_id": {
                "description": "Meter ID",
                "format": "uuid",
                "type": "string"
              }
            },
            "required": [
              "meter_id"
            ]
          }
        ],
        "required": [
          "meter_id",
          "nomination_kw",
          "start_date"
        ]
      }
    },
    "securitySchemes": {
      "Bearer": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}
```