---
title: "Tariff Optimize - Search for Recommended Applicable Tariffs"
method: POST
path: "/spark/optimized_tariffs/recommendations"
tags: ["Spark"]
---

# Tariff Optimize - Search for Recommended Applicable Tariffs

`POST /spark/optimized_tariffs/recommendations`

Returns a list of applicable tariffs to use in a Tariff-Scenario Cost Calculation given the answers to the submitted Applicability Questions.

The set of recommended 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)](https://developer.genability.com/api-reference/tariff-api/load-serving-entity/).

__Either utility_account_id or both the zip_code/lse_id must be specified.__

## Headers

- `Arcadia-Version` string, required

## Request body

- TariffApplicabilityAnswersRequestParams
  - `utility_account_id` integer — The unique ID of the Utility Account for this tariff search. Optional if searching for tariffs by Genability `lse_id`/`zip_code`.
  - `zip_code` string — 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_id` string — The ID of the Genability [load serving entity](https://developer.genability.com/api-reference/tariff-api/load-serving-entity/) prefixed with `gen_lse_`. Must be provided if searching for tariffs by Genability `lse_id`/`zip_code`.
  - `applicability_answers` TariffApplicabilityAnswerSchema[] — Site or customer-specific answers to applicability questions to determine tariff eligibility.
    - `question_id` string, required — String identifier for the applicability question
    - `value` boolean, required — User response to the tariff applicability question
    - `data_type` string, required — Type of answer expected to be returned for this tariff applicability question

## Response `200`

Success

- OptimizedTariffRecommendationsResponse
  - `country` string, required — The country used for determining tariff applicability
  - `lse_id` string, required — The Genability 'lseId' unique identifier for this load serving entity. See [Genability documentation](https://developer.genability.com/api-reference/tariff-api/load-serving-entity/) for details.
  - `zip_code` string, required — The zip code used for determining tariff applicability
  - `recommendations` Tariff[], required — List of tariffs that best fit the submitted applicability question answers. Used to define Tariff-Scenarios for the Calculate Tariff-Scenario Cost endpoint
    - `main_tariff_id` string, required — The Genability 'masterTariffId' unique identifier for this tariff. See [Genability documentation](https://developer.genability.com/api-reference/tariff-api/tariff/) for details.
    - `property_inputs` object[] — Properties applied to this tariff which may affect the calculated cost of electricity.
      - `id` string, required
      - `value` union, required
        - boolean
        - number
        - string
    - `supplier_name` string, nullable — The name of the retail electricity supplier or the community choice aggregator. If there is no retail electricity supplier or community choice aggregator, this field is null.
    - `tariff_code` string, required — Abbreviation code of the tariff used for this calculation.
    - `tariff_name` string, required — Full name of the tariff used for this calculation.
    - `utility_name` string, required — Name of the utility associated with this tariff

## Other responses

- `422` — Bad Request

---

[API](https://skmtc.dev/arcadia/apis/arcadia-api-reference.md) · [All operations](https://skmtc.dev/arcadia/apis/arcadia-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/arcadia/arcadia-api-reference/revisions/468f1c903722/schema)