Your books, by API.

Authentication

Create a key in the app (owner or admin only): More → API keys → New key. Pick read-only or read-write. The key is shown once; MileBrain stores a hash and cannot show it again. Send it as a bearer token:

curl https://milebrain.com/api/v1/loads \
  -H "Authorization: Bearer mbk_0123456789abcdef0123456789abcdef01234567"

A driver, a mechanic (outside shop), a customer-portal login and a demo sandbox can never create a key. A revoked key is refused on its very next call with 401 {"code":"REVOKED"}.

Limits

60 calls a minute and 1,000 an hour per key; past that you get 429 with a Retry-After header. Lists return at most 200 items a page — use limit and offset. Records are at most 300 KB.

Resources

PUT and DELETE need a read-write key; a read-only key gets 403 {"code":"READ_ONLY"}. Invoices, settlements and claims are read-only for every key — their numbers come out of the app’s own engines and are not accepted from outside.

Examples

List this month’s delivered loads

curl "https://milebrain.com/api/v1/loads?from=2026-09-01&to=2026-09-30&status=Delivered" \
  -H "Authorization: Bearer $MB_KEY"

{"ok":true,"total":14,"limit":200,"offset":0,"items":[{"id":"l-7f3a","customerName":"Acme Freight Brokers",
  "origin":"Detroit, MI","destination":"Chicago, IL","pickupDate":"2026-09-03","deliveryDate":"2026-09-04",
  "rate":"1850.00","miles":"283","status":"Delivered", ...}]}

Create or replace a load (read-write key)

PUT is an upsert on the id you choose. Fields you leave out of a PUT on an existing record are kept.

curl -X PUT https://milebrain.com/api/v1/loads/l-tms-10442 \
  -H "Authorization: Bearer $MB_KEY" -H "Content-Type: application/json" \
  -d '{"customerName":"Acme Freight Brokers","origin":"Detroit, MI","destination":"Chicago, IL",
       "pickupDate":"2026-09-12","deliveryDate":"2026-09-13","rate":"1850.00","miles":"283","status":"Booked","refNo":"PO 10442"}'

{"ok":true,"created":true,"load":{"id":"l-tms-10442", ...}}

Outstanding invoices for the accountant

curl "https://milebrain.com/api/v1/invoices" -H "Authorization: Bearer $MB_KEY" \
  | jq '.items[] | select(.paidAt=="") | {invoiceNo, customer, total, invoicedAt}'

Fuel stops, in Python

import requests
r = requests.get("https://milebrain.com/api/v1/fuel", params={"from": "2026-07-01", "to": "2026-09-30"},
                 headers={"Authorization": "Bearer " + MB_KEY})
for f in r.json()["items"]:
    print(f["date"], f.get("state"), f.get("gallons"), f.get("amount"))

Errors

Files instead of code

If what you actually need is a spreadsheet, the app already exports CSV for loads, fuel, repairs, the team, QuickBooks invoices and expenses, IFTA and payroll — under More → Exports. No key required.

The API is included on every plan — see pricing for the plan limits a key inherits, the features whose records it reads, and the help center for how those records get entered in the first place.