Integrations

Connect Vetrol
to your stack.

Vetrol is built to slot into your existing tools — ERP, accounting, fleet management, or custom dashboards. Use our REST API, subscribe to webhooks, or pull structured exports. Your data, your way.

REST API Webhooks EBM / RRA CSV Exports
REST API

Full REST API

Query vehicles, transactions, denied attempts, and station data. Write rules and manage your fleet programmatically.

Webhooks

Real-time Webhooks

Subscribe to transaction events and receive a POST payload the moment anything happens — approve, deny, alert, or settlement.

EBM / RRA

Automatic Tax Invoices

Every transaction generates a compliant EBM invoice and submits it directly to RRA. No manual action, no delays.

CSV Exports

Structured Data Exports

Export any dataset as CSV on demand or on a schedule. Designed for import into accounting software or spreadsheets.

REST API

Query and control your fleet programmatically.

The Vetrol REST API gives developers full programmatic access to fleet data, transaction history, rules management, and reporting. Authenticate with a per-account API key and start pulling data in minutes.

Available endpoints

GET /v1/vehicles List all vehicles and their current rules
GET /v1/transactions Query transaction history with filters
GET /v1/transactions/{id} Retrieve a single transaction
GET /v1/denied List all denied authorization attempts
GET /v1/stations List partner stations on your account
POST /v1/vehicles/{id}/rules Update rules for a specific vehicle
GET /v1/invoices List EBM invoices generated for your account
GET /v1/reports/summary Fleet cost summary for a date range
GET /v1/transactions 
// Request
curl -H "Authorization: Bearer vt_live_..." \
     -G https://api.vetrol.io/v1/transactions \
     -d "vehicle_id=veh_kgl047&limit=5"

// Response
{
  "data": [
    {
      "id": "txn_01HXYZ",
      "vehicle_id": "veh_kgl047",
      "station_id": "stn_rubis_kim",
      "volume_litres": 65.0,
      "amount_rwf": 176640,
      "status": "approved",
      "ebm_invoice_no": "EBM-2024-00847",
      "timestamp": "2024-11-14T09:08:33Z"
    }
  ],
  "meta": { "total": 1842, "page": 1 }
}
POST → your endpoint 
{
  "event": "transaction.approved",
  "timestamp": "2024-11-14T09:08:33Z",
  "data": {
    "transaction_id": "txn_01HXYZ",
    "vehicle_id":    "veh_kgl047",
    "vehicle_plate":  "RAE 847 A",
    "station_name":  "Rubis Kimironko",
    "fuel_type":     "diesel",
    "volume_litres": 65.0,
    "amount_rwf":    176640,
    "ebm_invoice":   "EBM-2024-00847"
  }
}
Webhooks

React to events the moment they happen.

Register a URL and Vetrol will POST a signed payload to it every time a relevant event occurs on your account — no polling, no delays. Use webhooks to trigger alerts, update your own systems, or feed data into your finance tools in real time.

Available events

transaction.approved A fueling event completed successfully
transaction.denied An authorization attempt was blocked
transaction.alert A fill triggered a watchlist rule
vehicle.rule_updated A vehicle's fuel policy was changed
invoice.generated An EBM invoice was created and submitted
settlement.completed A settlement batch was processed
EBM / RRA Integration

Tax invoices handled.
Automatically, always.

Vetrol is natively integrated with Rwanda Revenue Authority\'s Electronic Billing Machine system. The moment a transaction closes, a fully compliant EBM invoice is generated and submitted to RRA on your behalf. No station chasing. No manual uploads. No compliance gaps.

1

Transaction closes

Vehicle Tag authorised, volume dispensed, transaction recorded on the Vetrol ledger.

2

Invoice generated

EBM-compliant invoice created instantly — VAT calculated, company TIN applied, all fields populated.

3

Submitted to RRA

Invoice transmitted directly to RRA via the EBM integration. Available in your Vetrol dashboard immediately.

Get API Access

Ready to integrate?
Talk to our team.

API access is available to all Vetrol accounts. Contact us to get your API key, review the full documentation, and discuss your integration requirements.

Request API access Talk to us