Developers · Charge Signals

Build on the post-connect event and policy layer.

Vehicle APIs connect the car. Nerava Charge Signals turns those signals into verified events, campaign-rule decisions, and actions your application can consume — via partner-scoped APIs, webhooks, and a TypeScript SDK.

npm install @nerava/sdk
Request API access

What you integrate against

The Partner API exposes the same primitives as the platform — not a separate product surface.

Verified sessions

Submit or receive canonical charging sessions built from Tesla Fleet, Smartcar, and partner evidence — with confidence and source metadata.

Campaign rules

List eligible campaigns and let Nerava evaluate consent, location, time, budget, and frequency before an action fires.

Outcome delivery

Subscribe to signed webhooks for rule decisions and program actions. Idempotent by default so retries stay safe.

Partner isolation

Partner API keys are scoped and hashed. Workspaces stay isolated; trust tiers inform session quality scoring.

TypeScript SDK

Typed modules over the Partner API — sessions, campaigns, grants, and wallet helpers where your program uses Nerava-managed rewards.

Quick start

import { Nerava, usd, latLng } from "@nerava/sdk";

const nerava = new Nerava({
  apiKey: "nrv_pk_your_partner_key"
});

// Submit a charging session
const session = await nerava.sessions.submit({
  vehicleId: "v_abc",
  chargerId: "c_heights",
  ...latLng(31.0824, -97.6492),
});

// List campaigns eligible for this context
const campaigns = await nerava.campaigns.list({
  lat: 31.0824, lng: -97.6492,
});

// Credit a driver wallet when your program uses Nerava rewards
await nerava.wallet.credit({
  driverId: "drv_1",
  amount: usd(500),
  campaignId: "camp_1",
});

Built for production delivery

TypeScript-first SDK

Full type definitions for requests and responses. One NeravaError model discriminated by code.

Zero runtime dependencies

Uses native fetch on Node 18.17+. No axios, no node-fetch, no runtime bloat.

Idempotent mutations

Every mutating endpoint accepts idempotency keys. Safe to retry without creating duplicates.

Cent-integer money

Where wallets apply, amounts are integers in cents — no floating-point dollars at the API boundary.

Trust tiers

Hardware-verified (Tesla / Smartcar), API-verified, and app-reported tiers inform quality scoring.

Local mock server

Exercise SDK methods locally without production credentials before you request a partner key.

Partner APIs are live. Docs portal is expanding.

You can request a partner key and integrate sessions, grants, and webhooks today. Interactive docs, usage dashboards, and self-serve key management are still rolling out.

Talk to Nerava