Overview

Corporate API · v1.0

Run your corporate taxi program — programmatically.

The SwiftDrive Corporate API covers the full lifecycle of a business account: the department tree, employees and their travel policies, spending and ride limits, read-access to completed orders, and async report exports. Everything the admin panel does — exposed as JSON.

What you can do

Mirror your org chart

Nested departments, each with its own budget and policy.

Onboard employees at scale

Create, update, deactivate — with welcome SMS and travel policy assignment.

Enforce spending

Caps per cost, count, time of day, car class, zones, toll roads.

Monitor activity

Live remaining budget and a filterable feed of every order.

Export reports

Async XLSX/CSV jobs for orders or employees — for finance and HR.

Multi-role users

Users can wear several hats; each session runs under a selected role.

Shape of the API

• REST / JSON over HTTPS, OpenAPI 3.0
• 23 operations across 6 resource groups
• JWT Bearer authentication after POST /sign-in
• Uniform { status, data } response envelope
• List endpoints use POST with a JSON body for rich filters + paging
• Reports are asynchronous: create → poll → download

Where to go next

• Authentication — how to get and use a token
• Quick start — end-to-end curl walkthrough
• Domain model — how the entities relate
• API Reference — every endpoint, with Try-it-out