v1

latestOpenAPI 3.1.02026-07-1342111193.6 KB
Spark

Tariff Optimize - Get Tariff Applicability Questions

Gets the list of applicability questions for all potential tariffs. Tariffs sometimes have eligibility conditions to sign up for them ("applicabilities"). For example, signing up for an EV tariff often requires an electric car registered to the account holder at the account's address. Answers to the returned applicability questions can be passed to the recommendations endpoint to get the most relevant tariffs.

The set of potential tariffs can be specified either by an Arcadia Utility Account ID, or by considering all tariffs in a given zip code served by a specific Genability Load Serving Entity (LSE).

Either utility_account_id or both the zip_code/lse_id must be specified.

get/spark/optimized_tariffs/applicabilities

Query parameters

utility_account_idinteger

The unique ID of the Utility Account for this tariff search. Optional if searching for tariffs by Genability lse_id/zip_code.

zip_codestring

The zip code of the site inside the LSE's territory. Must be provided if searching for tariffs by Genability lse_id/zip_code.

lse_idstring

The ID of the Genability load serving entity prefixed with gen_lse_. Must be provided if searching for tariffs by Genability lse_id/zip_code.

Headers

Arcadia-Versionstring required

The Arcadia-Version for the request

Response

Success

countrystring required

The country used for determining tariff applicability

lse_idstring required

The Genability 'lseId' unique identifier for this load serving entity. See Genability documentation for details.

zip_codestring required

The zip code used for determining tariff applicability

Example response

{
  "country": "US",
  "lse_id": "gen_lse_734",
  "zip_code": "94706",
  "applicability_questions": [
    {
      "id": "EV",
      "user_question": "Do you have an electric vehicle (EV)?",
      "user_question_details": null,
      "answer_data_type": "YES_NO"
    },
    {
      "id": "SOLAR",
      "user_question": "Do you have a rooftop solar system installed?",
      "user_question_details": null,
      "answer_data_type": "YES_NO"
    },
    {
      "id": "ELECTRIC_HEAT",
      "user_question": "Is your primary home heating electric?",
      "user_question_details": null,
      "answer_data_type": "YES_NO"
    },
    {
      "id": "ELECTRIC_WATER",
      "user_question": "Is your primary hot water heater electric?",
      "user_question_details": null,
      "answer_data_type": "YES_NO"
    },
    {
      "id": "HEAT_PUMP",
      "user_question": "Do you have a heat pump for home heating and cooling?",
      "user_question_details": null,
      "answer_data_type": "YES_NO"
    },
    {
      "id": "SENIOR_CITIZEN",
      "user_question": "Is the electric account owner a senior citizen?",
      "user_question_details": null,
      "answer_data_type": "YES_NO"
    },
    {
      "id": "LOW_INCOME",
      "user_question": "Do you qualify for your utility's low income assistance program?",
      "user_question_details": "Contact your utility for specific qualifications, but common criteria include: Supplemental Security Income, Temporary Assistance to Needy Persons/Families, Safety Net Assistance, Food Stamps, or receiving a Home Energy Assistance Program grant in the preceding 12 months.",
      "answer_data_type": "YES_NO"
    },
    {
      "id": "MEDICAL",
      "user_question": "Do you have medical equipment or a condition that qualifies for electricity assistance?",
      "user_question_details": "Contact your utility for specific qualifications, but this commonly includes equipment like ventilators.",
      "answer_data_type": "YES_NO"
    },
    {
      "id": "CA_CARE_CUSTOMER",
      "user_question": "Do you qualify for the California Alternate Rates for Energy (CARE) program?",
      "user_question_details": "CARE provides qualifying residential applicants with reduced energy charges.",
      "answer_data_type": "YES_NO"
    },
    {
      "id": "CA_FERA",
      "user_question": "Do you qualify for the Family Electric Rate Assistance program (FERA)?",
      "user_question_details": "FERA is the rate reduction program in California for household with maximum annual income of between 200% and 250% of federal poverty guidelines and have three or more persons residing full time in their household. Additional eligibility criteria may apply.",
      "answer_data_type": "YES_NO"
    }
  ]
}