API v1

API Documentation

The KolayCharge Compat API provides programmatic access to EV–charger compatibility data.

Base URL: /api/v1 Rate limit: 60 req/min Format: JSON Auth: none (public beta)

Rate Limiting

60 requests per minute per IP. Exceeding returns HTTP 429.

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 58
X-RateLimit-Reset: 1748476800

Endpoints

GET /api/v1/vehicles/{slug}

Vehicle variant detail

Parameter	In	Description	Example
`slug`	path	Vehicle slug	`tesla-model-y-2024-awd-eu`

Response example

{ "id": "uuid", "slug": "...", "brand": "Tesla", "family": "Model Y",
  "max_dc_kw_oem": 250, "battery_kwh_usable": 75.0,
  "architecture_voltage_v": 400, "bidirectional": [] }

GET /api/v1/vehicles/{slug}/compatibility

Compatible chargers for vehicle

Parameter	In	Description	Example
`slug`	path	Vehicle slug	`tesla-model-y-2024-awd-eu`

Response example

{ "slug": "tesla-model-y-2024-awd-eu", "chargers": [...] }

GET /api/v1/chargers/{slug}

Charger model detail

Parameter	In	Description	Example
`slug`	path	Charger slug	`abb-terra-360`

Response example

{ "id": "uuid", "slug": "abb-terra-360", "brand": "ABB",
  "nominal_max_kw": 360, "current_kind": "DC",
  "output_voltage_min_v": 150, "output_voltage_max_v": 920 }

GET /api/v1/chargers/{slug}/compatibility

Compatible vehicles for charger

Parameter	In	Description	Example
`slug`	path	Charger slug	`abb-terra-360`

Response example

{ "slug": "abb-terra-360", "vehicles": [...] }

GET /api/v1/compatibility/{vehicleSlug}/{chargerSlug}

Single compatibility edge

Parameter	In	Description	Example
`vehicleSlug`	path	Vehicle slug	`tesla-model-y-2024-awd-eu`
`chargerSlug`	path	Charger slug	`abb-terra-360`
`region`	query	EU · TR · NA · GB	`EU`

Response example

{ "vehicle": "tesla-model-y-2024-awd-eu", "charger": "abb-terra-360",
  "region": "EU", "kw": 250, "state": "ok",
  "confidence": 0.75, "adapterRequired": false,
  "protocols": ["iso-15118-2"], "edgeVersion": 1,
  "derivationVersion": "graph-linker-v1",
  "createdAt": "2026-05-21", "sources": [] }

Compatibility States

state	Description
`ok`	Fully compatible
`adp`	Adapter required
`limited`	Charger-limited
`no`	Incompatible
`unk`	Unknown

Error Codes

HTTP	Error	Description
400	`slugs_required`	Missing required path parameter
404	`not_found`	Resource not found
429	`rate_limit_exceeded`	Rate limit exceeded — wait for reset