HomeGuidesAPI ReferenceChangelog
Log In
API Reference

Spark

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.

Spark utility and tariff coverage: Most Spark endpoints require EITHER the MTID (main_tariff_id) OR the utility_account_id. The choice of which input parameter you pass the API impacts the utility and tariff coverage available to you. 

  • Using MTID:
    • Tariff data: Coverage of ALL tariff data within the Arcadia tariff database (over 95% of US utilities)
    • Utility data: No access to utility data. The MTID bypasses the need to connect utility accounts. It uses Typical load curves in lieu of historical usage.
  • Using utility_account_id (this input parameter is still in beta and has limited coverage - Click here for a description of Arc’s release phases):
    • Tariff and utility data: limited list of utilities
      • 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.