Developers

Integrate in Minutes.
Ship Attribution at Scale.

One normalized webhook API. SHA-256 privacy by default. Sandbox environment included. Whether you're a CSMS operator or an ad tech team, VideoEV gives you a single integration surface for the entire EV charging ad stack.

Read the Architecture →
Quickstart

Three Steps to Live

From sandbox credentials to production events.

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
sandbox.api.videoev.io
Synthetic session data, no PII
Production
api.videoev.io
Live CSMS event streams
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 ship your first live event within the hour. Our integration team is available for CSMS onboarding calls.

Read the Architecture