Verify a pack in one request
Every Hub Report mints a Pack Passport. Point a GET request at that passport and you get back a signed, PII-free attestation of the pack's condition: state of health, cell spread, module grading result, load test, certification status, and a resale valuation band. No scraping, no dealer phone calls, no PDFs to read.
01 // Endpoint
GET https://hybridhubnetwork.lovable.app/api/public/verify/{passport_code}- · Response is cacheable for 5 minutes and CORS-open for browser-side verification.
- · signature is HMAC-SHA256 over the canonical JSON of payload, keyed with the shared secret issued to your organization. Recompute it before you trust the body.
- · Invalid or malformed passport codes return 400 with invalid_passport_code.
- · Requests are rate-limited per key at the network edge; contact us for volume tiers.
02 // Sample response
{
"ok": true,
"spec": "hhn-verify/1",
"algorithm": "HMAC-SHA256 over the canonical JSON of `payload`",
"payload": {
"report_id": "HHR-2026-4KJ8A2",
"vehicle": "2016 Toyota Prius",
"vin_masked": "JTDKARFU*8891",
"chemistry": "NiMH",
"score": 91,
"soh_pct": 89,
"cell_delta_mv": 34,
"load_test_pass": true,
"status": "Hub Certified",
"certified": true,
"warranty_active": true,
"cert_date": "2020-02-04",
"valuation_band_usd": { "low": 10420, "mid": 11085, "high": 11750 },
"issued_at": "2026-08-02T04:12:55.019Z"
},
"signature": "9f2c…"
}03 // Field reference
| Field | Meaning |
|---|---|
| report_id | Stable ledger identifier for the pack record. |
| vin_masked | First 8 and last 4 of the VIN only. Never the full VIN. |
| score | 0–100 composite diagnostic score across the last 30 telemetry pings. |
| soh_pct | Measured pack state of health, cell-level derived. |
| cell_delta_mv | Spread between highest and lowest cell. Rising delta precedes failure. |
| load_test_pass | Whether the pack held voltage under the rated load profile. |
| status | Hub Certified · Eligible · Needs Service · Non-Certified. |
| warranty_active | Whether network warranty coverage is currently in force. |
| valuation_band_usd | Deterministic resale band derived from SoH, score, mileage, chemistry. |
04 // What it's for
Underwriting
Price EV and hybrid policies against measured pack condition instead of model-year averages. A Grade-A verified pack is a materially different risk than an un-tested one of the same age.
Total-loss decisions
Pull the module-level grading and load result before writing a pack off. Roughly a third of packs flagged for replacement need one module, not forty.
Lending & lease residuals
Set residual values on the verified valuation band. The pack is the single largest depreciating component on the vehicle and, until now, the least measurable.
Fleet & remarketing
Batch-verify inbound units at auction. Signed attestations survive resale — the passport travels with the car, not the seller.
05 // What we never send
No owner name, email, phone, address, GPS trace, or full VIN — ever, on any plan, at any price. The attestation describes a battery, not a person. That constraint is the reason owners are willing to share pack data at all, and we will not trade it away.