Developers

Tote Car REST API

Everything the dashboard does, exposed as JSON over HTTPS. Create an API key from your dashboard and start pushing relocations from your fleet system.

Authentication

Send your API key in the x-api-key header on every request.

x-api-key: tk_live_...

POST /api/public/v1/relocations

Create a new relocation listing.

curl -X POST https://<your-app>/api/public/v1/relocations \
  -H "x-api-key: tk_live_..." \
  -H "content-type: application/json" \
  -d '{
    "vehicle_id": "a1000000-0000-0000-0000-000000000001",
    "pickup_city": "Auckland",
    "pickup_address": "12 Airport Rd",
    "dropoff_city": "Queenstown",
    "dropoff_address": "Frankton Airport",
    "distance_km": 1710,
    "available_from": "2026-07-10",
    "deadline_date": "2026-07-17",
    "free_days": 3,
    "extra_day_rate_cents": 4900,
    "free_km": 1800,
    "extra_km_rate_cents": 25,
    "hire_price_cents": 100,
    "fuel_included": true,
    "ferry_included": true,
    "insurance_included": true,
    "notes": "Fuel to $150 covered."
  }'
201 Created
{ "id": "…", "status": "open" }

GET /api/public/v1/relocations

List open relocations. No auth required.

curl https://<your-app>/api/public/v1/relocations?from=Auckland&to=Queenstown

Billing

You're charged a flat $50 per confirmed transfer. Cancelled or unbooked relocations are free.