FleetBoldDEV
Sign in

FleetBold Partner API

Track, unlock and command vehicles from your code

Live location, vehicle state, trips and bookings over REST, signed webhooks to your backend, and remote commands — lock, kill switch, honk, Tesla controls — on the fleets your users connect with OAuth.

  • GET/v1/vehicles/{id}/location
  • POST/v1/vehicles/{id}/commands
  • WEBHOOKvehicle.telemetry
  • AUTHOAuth 2.0 · PKCE · OIDC
Register an appRead the docs

Build and test with your own account and test users, go live after review. Requires a company email address.

Vehicle commands

Send a command, follow it end to end

One endpoint for every vehicle: POST /v1/vehicles/{vehicle_id}/commands. FleetBold sends it the way the FleetBold app does and answers 202 Accepted with a command resource. Results are pull-only: no command webhooks, you read GET /v1/commands/{command_id}.

Tesla: answered within the request

trunk_control_command, flash_lights_command and honk_horn_command go through the Tesla Fleet API, so the 202 already says succeeded.

Vehicle commands · Tesla
112233445566AABBCCDD2 8904 751https://your-app.example/vehiclesFleet console● onlineTesla · VIN 7SAYGDEE6PF421987Open trunkFlash lightsHonk horntesla_apiHTTPSTESLAveh_01JAWF… · VIN 7SAYGDEE6PF421987FLEETBOLD PARTNER APIpartners-api.fleetbold.comTHIRD-PARTY APPyour app · OAuth access token187.00, 97.00

Command:

Networkpartners-api.fleetbold.compaused

# Waiting for the app to send a command…

FleetBold device: kill switch

fleetbold/engine_cut and fleetbold/engine_recover go from your app to FleetBold, from FleetBold to the device in the vehicle, and the answer comes back the same way: 202 Accepted with sent.

Kill switch · FleetBold device
112233445566AABBCCDD4 836v = 48 km/hhttps://your-app.example/vehiclesFleet console● 48 km/hSUV · FleetBold device · VIN 1FMEE5DP5PLA30417Kill switchRecover enginedeviceHTTPSSUV · FLEETBOLD DEVICEveh_01J0P6… · VIN 1FMEE5DP5PLA30417FLEETBOLD PARTNER APIpartners-api.fleetbold.comTHIRD-PARTY APPyour app · OAuth access token187.00, 97.00

Command:

Networkpartners-api.fleetbold.compaused

# Waiting for the app to send a command…

Illustration. Engine cut can disable a vehicle: follow the safety guidance in the Vehicle commands guide.

Telemetry webhooks

Realtime vehicle data, one format

The vehicle streams telemetry to FleetBold all the time. FleetBold turns each provider's fields into one vehicle.telemetry event and posts it to your endpoint, signed with X-FleetBold-Signature, as each event arrives (no per-vehicle interval). Pause or resume it per connection with PATCH /v1/connection/webhook.

Telemetry webhook
112233445566AABBCCDDtelemetry · realtimewebhook · as events arrive4 751https://your-app.example/liveFleet console○ webhook pausedConnected vehicle · VIN 7SAYGDEE6PF421987Resume webhookSPEED—km/hBATTERY—ODOMETER—HEADING—waiting for the first event…endpoint /fleetbold/webhookstelemetry configHTTPS · configCONNECTED VEHICLEveh_01JAWF… · VIN 7SAYGDEE6PF421987FLEETBOLD PARTNER APIone format · vehicle.telemetryTHIRD-PARTY APPendpoint whk_01JZ8W… · /fleetbold/webhooks187.00, 97.00

Command:

Networkpartners-api.fleetbold.com ⇄ your-app.examplepaused

# Webhook paused: waiting for the app to resume it…

Illustration. Endpoints and data groups are set in the console; forwarding starts when the user grants webhooks:receive with location:read and offline_access. See the Webhooks guide.

OAuth 2.0 with consent
FleetBold users connect your app through a consent screen and choose exactly what they share.
Credentials you control
Register apps, manage redirect URIs and scopes, rotate secrets without downtime and add test users.
Events (coming soon)
App-level webhooks with signed deliveries, test events and delivery logs.

How it works

  1. 1

    Create a company account

    Sign up with your company email and accept the Developer Terms.

  2. 2

    Register your app

    Name, company, client type, redirect URIs and the scopes you need. Verify the contact email by link.

  3. 3

    Build and test

    Get your client id and secret, then test with your own account and test users while in development.

  4. 4

    Go live

    Submit for review. Once approved, any FleetBold user can connect your app.

Documentation

QuickstartOAuth 2.0API referenceErrorsRate limitsChangelog

Ready to build?

Create your developer account with your company email.

Register an appSign in