Skip to main content
Roadio (Road.io) is an EV charging network management platform that charge point operators use to manage locations, chargers, sessions, and billing. With BonData, you can connect to your Roadio account to read, enrich, and sync your charging network data within Agent workflows.

​
Roadio API Token Setup

BonData connects to the Roadio API at https://api.road.io using a bearer API token scoped to your operator (provider).

​
Step 1: Request an API Token

  1. Contact your Road.io / ChargeNow account team to request an API token for the integration
  2. They will issue a Bearer token scoped to your operator account
  3. Confirm your Provider identifier - the tenant or operator your credential is scoped to
The provider value is sent as the provider request header. Without it, all Road.io endpoints return 403 Forbidden, so make sure you have the correct operator identifier.

​
Step 2: Review the API Documentation

For endpoint details and object schemas, see the Road.io documentation.

​
Step 3: Enter Credentials in BonData

  1. In BonData, navigate to Integrations and select Roadio
  2. Enter your API Token and Provider
  3. Click Connect

​
Required Fields

​
Available Data

Once connected, BonData can sync the following Roadio objects:
  • Accounts - Customer and operator accounts
  • Locations - Charging site locations with address and coordinates
  • EVSE Controllers - Charge point controllers and firmware details
  • EVSE Issues - Faults and issues raised against chargers
  • Sessions - Charging sessions with energy, cost, and timestamps
  • Credit Sessions - Credit-based charging sessions
  • Vehicles - Registered vehicles with make, model, and license plate
  • Cards - RFID and charge cards
  • Tokens - Authorization tokens
  • Internal Tokens - Internal authorization tokens
  • Users - Platform users and roles
  • Customer Groups - Groupings of customer accounts
  • Charging Groups - Groupings of chargers
  • Charging Policies - Pricing and access policies
  • Access Groups - Access control groups
  • Billing Plans - Billing plans and pricing
  • Payment Terminals - Connected payment terminals
  • Credentials - Roaming and integration credentials
  • External Providers - Connected external providers
  • OCPI Locations - Locations exposed via the OCPI roaming protocol
  • OCPI Tariffs - Tariffs exposed via the OCPI roaming protocol