Franklin Whole Home

Franklin Whole Home (FranklinWH Energy Storage Inc.) builds whole-home energy management and storage hardware for residential solar: the aPower lithium iron phosphate AC battery, the aGate energy management and controller unit, and the FranklinWH mobile app, together forming an ecosystem that coordinates solar, battery, grid, generator and EV power sources for backup, self-consumption, time-of-use arbitrage and off-grid operation. Founded in 2019 and headquartered in the San Francisco Bay Area, the company designs and manufactures nearly all of its own components and sells through a certified installer and distributor channel. FranklinWH publishes a partner API - a unified developer access platform for authorised third-party owners, financiers, installers and service providers to read device and site data, monitor system performance, receive operational alerts and perform approved remote device control.

Franklin Whole Home publishes 1 API on the APIs.io network: FranklinWH API. Tagged areas include Company, Energy, Energy Storage, Home Energy Management, and Solar.

Franklin Whole Home’s developer surface includes API reference, engineering blog, support, documentation, signup flow, authentication, sandbox, and 18 more developer resources.

42.7/100 developing Agent 63/100 agent ready Full breakdown ↓
scored 2026-08-17 · rubric v0.11.0
1 APIs 1 MCP Servers
CompanyEnergyEnergy StorageHome Energy ManagementSolarBatteriesInternet of ThingsSmart HomeElectric VehiclesCleantechDevice Telemetry

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-08-17 · rubric v0.11.0
Composite quality — 42.7/100 · developing
Contract Quality 12.6 / 21
Developer Ergonomics 10.7 / 17
Commercial Clarity 5.8 / 17
Operational Transparency 0.0 / 11
Governance 2.1 / 10
Discoverability 6.5 / 9
Regulatory Posture 5.1 / 15
Agent readiness — 63/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 12 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 7 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 5 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Regulatory Posture applies to this provider. Its tags matched the Energy & Utilities regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
The six quality facets above are damped to 85 points between them, because the conditional facet above carries the other 15. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 85% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/franklin-whole-home: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 1

Individual APIs this provider publishes, each with its own machine-readable definition.

FranklinWH API

The FranklinWH partner API - a unified developer access platform for authorised partners to connect to FranklinWH systems. Thirty-eight operations across a standard namespace (/...

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Franklin Whole Home Rate Limits

0 limits

RATE LIMITS

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Franklin Whole Home Authentication

apiKey · 1 scheme

SECURITY

Franklin Whole Home Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Franklin Whole Home Agentic Access

38 operations · 19 acting

38 operations · 19 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 4

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 5

Pagination, idempotency, versioning, errors, and events

Build 1

SDKs, sample code, and the tooling you integrate with

Access & Security 2

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 3

Pricing, plans, and the legal terms of use

Company 2

The organization behind the API

Source (apis.yml)

apis.yml Raw ↑
aid: franklin-whole-home
name: Franklin Whole Home
description: 'Franklin Whole Home (FranklinWH Energy Storage Inc.) builds whole-home energy management and storage hardware
  for residential solar: the aPower lithium iron phosphate AC battery, the aGate energy management and controller unit, and
  the FranklinWH mobile app, together forming an ecosystem that coordinates solar, battery, grid, generator and EV power sources
  for backup, self-consumption, time-of-use arbitrage and off-grid operation. Founded in 2019 and headquartered in the San
  Francisco Bay Area, the company designs and manufactures nearly all of its own components and sells through a certified
  installer and distributor channel. FranklinWH publishes a partner API - a unified developer access platform for authorised
  third-party owners, financiers, installers and service providers to read device and site data, monitor system performance,
  receive operational alerts and perform approved remote device control.'
image: https://www.franklinwh.com/icoLogo1.png
url: https://raw.githubusercontent.com/api-evangelist/franklin-whole-home/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
x-tier: profiled
x-tier-reason: enrichment-pipeline
specificationVersion: '0.20'
created: '2026-08-16'
modified: '2026-08-16'
tags:
- Company
- Energy
- Energy Storage
- Home Energy Management
- Solar
- Batteries
- Internet of Things
- Smart Home
- Electric Vehicles
- Cleantech
- Device Telemetry
apis:
- aid: franklin-whole-home:franklinwh-api
  name: FranklinWH API
  description: 'The FranklinWH partner API - a unified developer access platform for authorised partners to connect to FranklinWH
    systems. Thirty-eight operations across a standard namespace (/api-common/) covering sites, device inventory, device parameters
    and running status, power/energy/telemetry data, historical warnings and backup events, time-of-use profiles, aPower switch
    control, smart circuits, grid events, device grouping and a modification audit log; plus a Sunrun-specific namespace (/api-sunrun/).
    Token authentication: a cp/ck credential pair is exchanged at /api-common/tokenizer for a token sent in the Authorization
    header.'
  humanURL: https://api.franklinwh.com/
  baseURL: https://test-api.franklinwh.com
  tags:
  - Energy Storage
  - Home Energy Management
  - Device Telemetry
  - Solar
  properties:
  - type: OpenAPI
    url: openapi/franklin-whole-home-openapi.yml
  - type: Overlay
    url: overlays/franklin-whole-home-openapi-overlay.yaml
  - type: Documentation
    url: https://api.franklinwh.com/
  - type: Announcement
    url: https://www.franklinwh.com/blog/introducing-the-franklinwh-api
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://www.franklinwh.com/
- type: DeveloperPortal
  url: https://api.franklinwh.com/
- type: APIReference
  url: https://api.franklinwh.com/
- type: Blog
  url: https://www.franklinwh.com/blog/
- type: Support
  url: https://www.franklinwh.com/support/contact/
- type: HelpCenter
  url: https://www.franklinwh.com/support/articles/faq/
- type: Documentation
  url: https://www.franklinwh.com/support/documents/
- type: SignUp
  url: https://www.franklinwh.com/apply?role=installer
- type: TermsOfService
  url: https://www.franklinwh.com/terms-of-use/
- type: PrivacyPolicy
  url: https://www.franklinwh.com/policy/
- type: Authentication
  url: authentication/franklin-whole-home-authentication.yml
- type: Conventions
  url: conventions/franklin-whole-home-conventions.yml
- type: ErrorCatalog
  url: errors/franklin-whole-home-problem-types.yml
- type: Lifecycle
  url: lifecycle/franklin-whole-home-lifecycle.yml
- type: Conformance
  url: conformance/franklin-whole-home-conformance.yml
- type: DataModel
  url: data-model/franklin-whole-home-data-model.yml
- type: Sandbox
  url: sandbox/franklin-whole-home-sandbox.yml
- type: Packages
  url: packages/franklin-whole-home-packages.yml
- type: MCPServer
  url: mcp/franklin-whole-home-mcp.yml
- type: AgentSkill
  url: skills/_index.yml
- type: LLMsTxt
  url: llms/franklin-whole-home-llms.txt
- type: RateLimits
  url: rate-limits/franklin-whole-home-rate-limits.yml
- type: Plans
  url: plans/franklin-whole-home-plans-pricing.yml
- type: DomainSecurity
  url: security/franklin-whole-home-domain-security.yml
- type: AgenticAccess
  url: agentic-access/franklin-whole-home-agentic-access.yml
x-enrichment:
  date: '2026-08-16'
  status: enriched
  artifacts_added: 21
  pass: local-v1