Partner API · GraphQL

Telemetry and Device Control
for Lion Energy Fleets.

One GraphQL endpoint for TPOs, VPP aggregators and enterprise partners. Read battery data, control devices, and dispatch fleets with scoped machine-to-machine credentials.

POSThttps://partner.lionenergy.com/graphql
query SanctuaryProductDataLatest {
    sanctuaryProductDataLatest(productId: "<product_id>") {
        id
        productId
        name
        time
        measures
        installationData
    }
}
Response
{
    "data": {
        "sanctuaryProductDataLatest": {
            "productId": "<product_id>",
            "name": "<product_name>",
            "time": "2026-11-18T23:04:13.000Z",
            "measures": { ... },
            "installationData": { ... }
        }
    }
}
One Endpointpartner.lionenergy.com/graphql
OAuth 2.0 Client CredentialsNo API keys, no user logins
Scoped AccessRead and control are separate
Public ChangelogEvery schema change, dated

Built for Three Kinds of Partners

TPOs

Model and Bill from Real Data

Pull energy totals and performance history for every system you finance.

Enterprise & installers

Diagnose without a Site Visit

Check device status, firmware and recent readings before you roll a truck.

VPP aggregators

See Capacity, Dispatch Fleets

Know what's available right now and schedule grid events across thousands of batteries.

API Limits

What the Partner API provides, and the limits every integration runs under.

Data resolution
5 minutes
History retention
12 months
Token lifetime
1 hour
Hands typing on a laptop at a desk

First Call in Three Steps

  1. Create CredentialsPick your scopes. Request a client ID and secret.
  2. Get a TokenTrade them for a short-lived access token.
  3. Send a Query or MutationAsk for exactly the fields you need. Execute dispatch commands.

Ready to Build?

Request access to start building, or get in touch with us.