# ZBE API — Low Emission Zones (ZBE/LEZ) for Spain & Portugal

> API-First, AI-First service for checking vehicle routes against Low Emission Zone polygons.

## Overview
The ZBE API checks if a vehicle route intersects Low Emission Zone (ZBE/LEZ) polygons in Spain and Portugal, validates DGT environmental badges, and provides restriction data per city.

Base URL: `https://zbe.transcend.cargoffer.com/api`

## Authentication
All endpoints require an API key via the `x-api-key` header.

**🔑 Get your free API Key:** https://zbe.cargoffer.com/api-key (or https://transcend.cargoffer.com → Dashboard → API Keys)

## Endpoints

### POST /api/zbe/check-route
Check if a vehicle route intersects ZBE polygons.
- Input: `{ route: [{lat, lon}], vehicle: { euroClass, fuelType } }`
- Output: `{ intersections: [...], restricted: boolean, badges: [...] }`

### GET /api/zbe/polygons
List ZBE polygons with filters (country, city, bbox).
- Query: `?country=ES&city=Madrid`

### GET /api/zbe/stats
Coverage statistics: total ZBEs, breakdown by country, last update.

## MCP Server
Package: `cargoffer-zbe-mcp` (npm)
```bash
npx cargoffer-zbe-mcp
```
Configuration:
```json
{
  "mcpServers": {
    "zbe": {
      "command": "npx",
      "args": ["cargoffer-zbe-mcp"],
      "env": { "ZBE_API_KEY": "YOUR_KEY" }
    }
  }
}
```

## SDKs
- JavaScript: `@cargoffer/zbe-sdk` (npm)
- Python: `cargoffer-zbe` (PyPI)

## Links
- API Docs: https://zbe.transcend.cargoffer.com/api/docs.json
- GitHub: https://github.com/cargoffer/mcp-server-zbe
- Website: https://zbe.cargoffer.com
- Parent platform: https://transcend.cargoffer.com (TRANSCEND TMS, Bolsa de Carga, eCMR/DeCA)

## Analytics
- Umami (self-hosted): website_id b2f613a6-d28b-4d5b-96f8-595dc9965d9d
- Tracked events: cta:click_*, nav:api_key_click, code:view_block_*