Rollyy Data API

Unified parking and EV charging data for smart mobility

The Rollyy Data API provides real-time access to parking and EV charging infrastructure across municipalities and operators. Build mobility apps, manage parking operations, or integrate autonomous charging with a single, reliable API.

Key Features

🚗 Parking Management

Access parking spots, garages, and street parking data with real-time availability.

⚡ EV Charging

Find charging stations, check availability, and manage charging sessions.

🔌 OCPI 2.2.1 Roaming

Connect to any OCPI-compliant charging network. Start and stop sessions at CPOs across Europe via Virta, Shell, Hubject, and Gireve.

🪪 EV Pass

Driver identity, wallet, and session history. Each user gets a persistent rolo_id used across all charging and parking activity.

📍 Geospatial Search

PostGIS-powered location search with radius queries and polygon filtering.

🔔 Real-time Updates

Live availability data for charging stations and parking spots.

🤖 Autonomous Operations

Manage robot charging jobs — the robot finds a charger, initiates an OCPI session, and handles the full charging lifecycle automatically.

🔐 Multi-Tenant

Secure tenant isolation with API key authentication.

Quick Example

# Search for charging stations near Helsinki
curl -H "X-API-Key: your-api-key" \
  "https://api.rollyy.com/v1/places/search?lat=60.1699&lon=24.9384&radius=1000"

{
  "data": [
    {
      "id": "place_123",
      "name": "Central Charging Hub",
      "location": { "lat": 60.1699, "lon": 24.9384 },
      "charging_assets": 12,
      "available_spots": 5
    }
  ]
}

Use Cases

For Autonomous Robots

• Locate nearest available EVSE
• Initiate OCPI charging session
• Monitor session and receive CDR
• Trigger automatic payment on completion

For EV Drivers (EV Pass)

• View charging history and receipts
• Manage wallet balance
• Find nearby chargers

For Municipalities

• Aggregate parking data across vendors
• Monitor occupancy and revenue
• Provide unified citizen access

For Developers

• Build EV charging apps
• Integrate OCPI roaming
• Create booking systems

Getting Started

1. Get API Access - Request your API key
2. Authentication - Learn how to authenticate
3. OCPI - Connect to charging networks
4. GitHub - View source code

API Endpoints

Endpoint	Description
GET /v1/places	List all places
GET /v1/places/search	Geospatial search
GET /v1/parking-assets	List parking assets
GET /v1/charging-assets	List charging stations
GET /v1/availability	Real-time availability
POST /v1/bookings	Create a booking
POST /v1/robot-jobs	Create autonomous charging job
POST /ocpi/register	Connect to a CPO via OCPI
POST /ocpi/2.2.1/commands/START_SESSION	Start charging session
POST /ocpi/2.2.1/commands/STOP_SESSION	Stop charging session
GET /v1/id/ev-pass	Get EV Pass profile
GET /v1/id/history	Charging and parking history
GET /v1/wallet/balance	Wallet balance

Support

• Email: support@rollyy.com
• GitHub: github.com/rollyycom/api