Spark (Beta)

The endpoints in this section are in beta. Click here for a description on Arc's release phases.

The following Spark endpoints are accessible using your Arc API key:

  • Tariff Rate API - returns the marginal cost of energy for a given tariff over a specified period of time, exclusive of utility fees.
  • Charge Cost API - calculates the cost of a charge session, based on the amount of energy needed for the charge, and the associated energy costs of a given tariff, exclusive of utility fees.
  • Smart Charge API - returns an optimized charge schedule given the charge session parameters and rate structure of the tariff.
  • Tariff Optimize APIs - provide a simple workflow to qualify available tariffs in a given market based on eligibility criteria, and then calculate the cost of a typical baseline load scenario for a particular combination of energy demand and energy device parameters, in order to determine the most cost-effective tariff.

These endpoints can accept the utility_account_id parameter value (returned through a connected user's Plug response) to automatically personalize the response to a user's account. They can also accept 'MTID' (Main Tariff ID) to access these features when an end user account is not available.

*Note: Only MTID (main_tariff_id) or utility_account_id is required. MTIDs can be retrieved using Spark's Signal product, or by contacting our success team for a batch file. Using utility_account_id is currently available in the following markets.

  • Ameren
  • Commonwealth Edison (IL)
  • Consolidated Edison
  • DTE Energy
  • Eversource (MA)
  • Florida Power & Light
  • Georgia Power
  • Los Angeles Dept. of Water & Power
  • PG&E
  • SCE
  • SDG&E
  • Xcel Energy

To test Spark features using utility_account id without using real utility credentials:

  • Use the zip code 93111 and select PG&E as the utility
  • Enter a test username that has an electric account
  • To test features against multiple tariffs, use the ARC_TEST_R_MULTI_ELEC username

We're actively building new features and invite you to reach out to our team so we can learn about your use cases and feature needs.