> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Roadio

> Connect BonData to Roadio for EV charging network and session data

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

<Note>
  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.
</Note>

### Step 2: Review the API Documentation

For endpoint details and object schemas, see the [Road.io documentation](https://documentation.road.io).

### 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

| Field     | Description                                         |
| --------- | --------------------------------------------------- |
| API Token | Bearer token issued by the Road.io / ChargeNow team |
| Provider  | Operator identifier sent as the `provider` header   |

## 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