Quick Switch Request Template

Use this request template to run a Quick Switch Savings Analysis with Arcadia Typical Baseline data.

For the full Savings Analysis request and response model, see Savings Analysis. To compare templates, see Savings Analysis Request Templates. For the full analysis workflow, see Analysis APIs.

What is a Quick Switch?

A Quick Switch is a Savings Analysis that uses Arcadia Typical Baseline data. Typical Baselines approximate usage and solar production based on the account's geographic location from its address.

Quick Switch vs. Full Switch

A Quick Switch uses Typical Baseline data when real-world usage or solar production profiles are unavailable. A Full Switch uses user-supplied profiles, such as real-world hourly usage and solar production data stored in profiles.

Using a custom user-supplied profile in a Savings Analysis request triggers a Full Switch flow.

Quick Switch template

{
    "accountId": "c02af6c6-9cb1-4ea1-bd82-61e419e0a754",
    "fromDateTime": "2025-10-01T00:00:00+00:00",
    "useIntelligentBaselining": true,
    "propertyInputs": [
        {
            "keyName": "projectDuration",
            "dataType": "INTEGER",
            "dataValue": "20"
        },
        {
            "keyName": "baselineType",
            "dataType": "STRING",
            "dataValue": "typicalSolarPv",
            "scenarios": "after,solar",
            "operator": "-"
        },
        {
            "keyName": "solarPvLoadOffset",
            "unit": "%",
            "dataValue": "80",
            "scenarios": "after,solar"
        },
        {
            "keyName": "rateInflation",
            "dataType": "DECIMAL",
            "dataValue": "1.9",
            "scenarios": "solar"
        },
        {
            "keyName": "baselineType",
            "dataType": "STRING",
            "dataValue": "typicalElectricity",
            "scenarios": "before,after"
        },
        {
            "keyName": "rateInflation",
            "dataType": "DECIMAL",
            "dataValue": "3",
            "scenarios": "before,after"
        },
        {
            "keyName": "masterTariffId",
            "displayName": "Residential",
            "dataType": "INTEGER",
            "dataValue": "512",
            "scenarios": "before"
        },
        {
            "keyName": "lseId",
            "displayName": "Georgia Power Co",
            "dataType": "INTEGER",
            "dataValue": "2756",
            "scenarios": "before"
        },
        {
            "keyName": "tariffCode",
            "displayName": "R-30",
            "dataType": "STRING",
            "dataValue": "R-30",
            "scenarios": "before"
        }
    ],
    "rateInputs": [
        {
            "chargeType": "CONSUMPTION_BASED",
            "chargePeriod": "MONTHLY",
            "transactionType": "BUY",
            "rateBands": [
                {
                    "rateAmount": 0.15
                }
            ],
            "scenarios": "solar"
        }
    ]
}

How to interpret the template

The request starts with top-level fields that identify the account and analysis start time.

• Use accountId or providerAccountId to identify the account.
• Use fromDateTime to set the analysis start time.
• Set useIntelligentBaselining to true when using Typical Baselines.

propertyInputs list

The propertyInputs list contains key/value objects that affect the calculation. These inputs can reference profile data, such as "keyName": "profileId", or account and tariff criteria, such as "keyName": "lowIncomeCustomer".

Review Properties API to understand available property keys and metadata. For guidance on using properties to improve savings analysis accuracy, see Improve calculation accuracy with rate criteria properties.

Because this is a Quick Switch, the request uses Arcadia's typicalElectricity and typicalSolarPv baseline types. These provide default approximations when real-world data is not available. When using Typical Baselines, set "useIntelligentBaselining": true.

rateInputs list

The rateInputs list contains custom rates or adjustments for the calculation. In this template, the request models a PPA at a $0.15/kWh rate.

You can also include supplemental items that may not be captured by tariff models, such as local or state taxes. For more detail, see User-adjusted rates, Contracted rates in deregulated markets, and Handle taxes.

Next steps

1. Return to Savings Analysis Request Templates to compare Quick Switch, Full Switch, and Storage-in-Switch.
2. Use Savings Analysis Request Structure to adapt the template to your own propertyInputs.
3. Use Savings Analysis to review the full request and response model.