Developers

Integrate in Minutes.
Ship Attribution at Scale.

One normalized webhook API. SHA-256 privacy by default. Sandbox access available to partners on request. The API surface below is the target contract for the v1 preview: current CSMS and ad-tech partners run against an early-access build today. Production scale-out coincides with the SOC 2 Type II audit currently underway.

Read the Architecture →
Quickstart

Three-Step Integration

Target contract for v1 preview. Sandbox credentials are issued on approval during CSMS onboarding.

01
Get your API key
Request sandbox access from the VideoEV partnerships team. You'll receive a Bearer token scoped to your CSMS or ad network.
02
Send your first event
POST a session-event webhook. VideoEV normalizes the payload, hashes the vehicle token, and returns segment eligibility.
curl -X POST https://api.videoev.io/v1/webhooks/session-event \
  -H "Authorization: Bearer <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "session_start",
    "session_id": "ev_sess_f7a2b4c",
    "hashed_vehicle_token": "sha256:a3f4b2c8d9e1...",
    "charger_id": "site_xyz_port_2",
    "current_soc_percent": 18,
    "estimated_dwell_time_mins": 42,
    "network_id": "evconnect_west",
    "timestamp_utc": "2026-03-08T14:22:33Z"
  }'
03
Receive the response
VideoEV returns segment eligibility, recommended creative format, and estimated inventory window, ready to route to your DSP.
{
  "status": "queued",
  "ad_eligible": true,
  "matched_segment": "ev_buyer_high_intent",
  "recommended_creative_format": "video_15s",
  "estimated_inventory_window_mins": 42
}
API Reference

Endpoints

Base URL: https://api.videoev.io

Method
Path & Description
Category
POST
/v1/webhooks/session-event
Ingest a charging session lifecycle event from any CSMS.
Core
GET
/v1/sessions/{session_id}
Retrieve the normalized record for a specific session.
Core
GET
/v1/segments
List available AMC audience segments for targeting.
Attribution
POST
/v1/attribution/match
Match a hashed vehicle token against an AMC segment.
Attribution
GET
/v1/health
Platform health check, returns service status.
Utility
Authentication

Bearer Token

All requests require an Authorization: Bearer <token> header. Tokens are environment-scoped (sandbox / production) and partner-scoped (CSMS, DSP, measurement).

Authorization: Bearer vev_live_f7a2b4c8d9...
Rate Limits

Tiered by Plan

Sandbox1,000 req/day
Starter50K req/day
ProductionUnlimited
Environments

Sandbox & Production

Sandbox
Issued on approval
Synthetic session data, no PII. URLs and credentials handed out to approved partners during onboarding, not public.
Production
Scale-out gated by SOC 2
Production endpoints activate on a partner-by-partner basis as SOC 2 Type II closes out and CSMS integrations ramp.
Error Codes

Standard HTTP

202Accepted , Event queued for processing
400Bad Request , Missing or invalid fields
401Unauthorized , Invalid or expired token
429Too Many Requests , Rate limit exceeded

Ready to build?

Request sandbox credentials and our integration team will work with you on CSMS onboarding. First-event turnaround depends on your CSMS and signal mapping; most partners ship a working event inside the onboarding call.

Read the Architecture

Platform Status

Where VideoEV is today.

VideoEV is in active pilot, not a fully productionized network. This strip is the single source of truth for the platform’s operational posture. If a page elsewhere reads as more productionized than this, trust this strip.

Product
Active pilot
Pilot campaigns running on OCPP-compatible hardware. Aggregate pilot benchmarks publish on /how-it-works#methodology once volume supports a stable figure.
Inventory posture
Walled garden
VideoEV is currently a closed inventory network. Demand runs through the VideoEV self-serve console and direct IO with our media team. External DSP integrations (Amazon DSP, The Trade Desk, Vistar) are target paths on the roadmap, not live production integrations.
CSMS integrations
OCPP-compatible
VideoEV reads OCPP 2.0.1 natively. Driivz, AMPECO, ChargeLab, and EV Connect are the target CSMS platforms for the read-only integration. Live event streams are not yet in production; no commercial partnerships are contracted.
Public API
v1 preview (early access)
The API surface on /developers is the target contract for v1. Sandbox URLs and credentials are issued to approved partners during onboarding, not publicly published. Production scale-out is gated by SOC 2 Type II.
Attribution
Pixel today · AMC-ready
Default measurement today is pixel-based. VideoEV exports hashed exposures in AMC's advertiser-uploaded-data schema; clean-room match runs inside the advertiser's own AMC instance once connected. VideoEV does not operate the clean room, and direct VideoEV ↔ AMC live plumbing is not in production.
SOC 2 Type II
In progress
Controls implemented, audit engagement planned for H2 2026. GDPR and CCPA / CPRA posture is designed-for alignment; counsel review pending.