API Docs

Boxaloo API Reference

The Boxaloo API lets approved brokers post, update, and delete loads directly from their TMS or custom software. All requests require a valid API key.

Base URL

https://loads.boxaloo.com/api/loads

Authentication

Include your API key in the Authorization header of every request.

Example

Authorization: Bearer bxl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠

Never expose your API key in client-side code or public repositories. Treat it like a password.

Rate Limits

Requests are limited to 100 per hour per API key. Exceeding this limit returns a 429 status code. Rate limits reset on a rolling 1-hour window.

Example

// 429 response when rate limit exceeded
{
  "error": "Rate limit exceeded. Max 100 requests/hour."
}

Valid Equipment Types

The equipment_type field must be one of the following values:

Box TruckCargo VanSprinter VanHotshot

Endpoints

Error Codes

Code	Meaning
400	Bad request — missing or invalid fields
401	Unauthorized — invalid or missing API key
403	Forbidden — your key lacks permission or you don't own this load
404	Not found — load ID does not exist
429	Rate limit exceeded — max 100 requests/hour
500	Server error — try again or contact support

Example Integration

Post a load using fetch in Node.js:

Example

const response = await fetch("https://loads.boxaloo.com/api/loads", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer bxl_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  },
  body: JSON.stringify({
    pickup_city: "Dallas",
    pickup_state: "TX",
    dropoff_city: "Los Angeles",
    dropoff_state: "CA",
    equipment_type: "Box Truck",
    pay_rate: 2400,
    total_miles: 1430,
    pickup_date: "2026-04-01",
    dropoff_date: "2026-04-03",
    weight: 8000,
    notes: "Liftgate required at delivery. 20ft box truck minimum."
  })
})

const data = await response.json()
console.log(data.load_id) // "BXL-M8F3K2"

Need help with your integration?

Our team is available to help you get set up.

Contact Support