What is a vehicle transport API?
A vehicle transport API lets a dealer, dealer group, or auction create and follow vehicle shipments from their own software instead of a transport provider's portal. The order is placed where the car is bought or sold, in a DMS, an inventory tool, a buying platform, or an auction checkout, and status comes back the same way. The test of a useful one is not whether it can create an order but whether it tells you what happened afterward: when the vehicle was picked up, what condition it was in, and when it was delivered, without anyone polling for updates.
Carpool Logistics is a managed vehicle transport platform that moves 215,000+ vehicles a year for dealers, dealer groups, auctions, and fleets. The Carpool API is the same service by other means: you send the VIN and the lane, Carpool prices it, assigns a vetted carrier, tracks it live, and handles the exception if there is one. The API simply puts the order and the events where your team already works.
What the Carpool Logistics API does
- Quotes. Post an origin, a destination, and up to 36 vehicles by VIN, year, make, model, type, and running status, and get economy, expedited, and enclosed prices with delivery estimates and lane distance. A quote stays valid for 30 days and can be turned into an order at the quoted price.
- Orders. Create an order from a quote (pass the quote ID and a price option) or directly, with up to 36 vehicles, a first-available date, and your own external IDs on the order and each vehicle. Attach an auction gate pass to a vehicle at order time, as a URL or base64 file (PDF, JPG, PNG, HEIC, or DOC up to 5 MB), so the pickup is cleared before the carrier is assigned. List, retrieve, and cancel orders through the same resource.
- Billing to the right party. A group or platform account can bill a move to its own account or to a child customer it manages, such as an individual rooftop, a dealer buying through your auction, or a franchise location, with one API token. Child customers are created through the API, or created and billed in the same request as the order, and are typed as auction, franchise dealer, independent dealer, digital platform, fleet, rental company, upfitter, finance and insurance, or private owner.
- Vehicles. List and retrieve every vehicle on the orders your token can see, newest first, one item per vehicle: status, quoted transport fee, signed tracking link, lane miles, pickup ETA, delivery and estimated delivery dates, PO number, and load ID. A parent token sees its own and its child customers' vehicles; a child token sees only its own.
- Outbound webhooks. Register a URL, choose the events you want, and Carpool posts them to you as they happen. Each delivery is signed with HMAC-SHA256 and timestamped, retried every five minutes up to ten times if your endpoint does not return a 2xx within 30 seconds, and carries a stable delivery ID for idempotency. Delivery history, including attempt counts and response codes, is available per webhook.
- Developer tooling. Bearer-token authentication with a token you generate in your Carpool dashboard, standard HTTP status codes with rate limiting (429 when exceeded), a full endpoint reference, a downloadable OpenAPI 3.0 specification for code generation, a Postman collection, and a test-event endpoint for checking your webhook handler before a real vehicle moves.
Carpool Logistics API endpoints at a glance
| Resource | Endpoints | Notes |
|---|---|---|
| Customers | POST /api/customers, GET /api/customers, GET /api/customers/{id} | Child customers under your account; nine customer types |
| Quotes | POST /api/customer/quote, GET /api/customer/quote/{id} | Up to 36 vehicles; economy, expedited, enclosed options; valid 30 days |
| Orders | POST /api/orders, GET /api/orders, GET /api/orders/{id}, DELETE /api/orders/{id} | With or without a quote; gate pass per vehicle; cancel with DELETE |
| Vehicles | GET /api/vehicles, GET /api/vehicles/{id} | One item per vehicle, newest first, with tracking link and dates |
| Webhooks | GET/POST /api/webhooks, GET/PATCH/DELETE /api/webhooks/{id}, GET /api/webhooks/{id}/deliveries, POST /api/webhooks/{id}/test, GET /api/webhook-events | Signed, retried, with delivery history and a test event |
Webhook events the Carpool Logistics API sends
| Event | Fires when | What the payload carries |
|---|---|---|
order.created | An order is accepted | Origin, destination, reference number, every vehicle on the order |
vehicle.created | A vehicle is added to an order | VIN, year, make, model, operable flag, rate, tracking link |
vehicle.picked_up | The carrier loads the vehicle | Actual pickup timestamp and current status |
vehicle.pickup_inspection_completed | The pickup inspection is signed | Damage codes with location, inspection photos, customer and driver signatures |
vehicle.delivered | The vehicle reaches the destination | Actual delivery timestamp |
vehicle.delivery_inspection_completed | The delivery inspection is signed | Delivery-side damage record, photos, signatures |
vehicle.canceled | A vehicle is removed from a move | Final status |
order.picked_up / order.delivered | Every active vehicle on the order reaches that status | Aggregate order status; vehicles on hold, canceled, or marked dry run are excluded |
order.canceled | An order is canceled | Final status |
Inspection events are the ones most dealers end up relying on. They put the geo-tagged pickup and delivery photos, the damage map, and the signatures into your own system at the moment they are captured, which is what settles a condition dispute without a phone call.
How dealers and auctions use the API
- Order at the point of purchase. A dealer group's buying tool or DMS creates the Carpool order the moment a unit is won at auction or acquired in a trade, with the gate pass attached. No one re-keys a VIN into a second system.
- Transport inside an auction checkout. An auction platform quotes delivery next to the bid and creates the order at settlement, billing the buying dealer as a child customer. The auction checkout page covers the widget option for platforms that do not want to integrate.
- Events into the warehouse. Groups subscribe to pickup, delivery, and inspection events and land them in their BI stack, so days-to-dispatch, transit time, and damage rate are reported per rooftop and lane from Carpool's own timestamps. The FVL KPIs for dealer groups post defines the metrics.
- Fleet and remarketing systems. Fleet operators push de-fleet cohorts as multi-vehicle orders and receive delivered events ahead of auction run dates. See fleet vehicle shipping with full tracking.
If you do not want to write code
The API is one of three ways into the same service. The Carpool browser extension quotes and orders from any VIN on any website, including auction run lists and your own inventory pages, with no integration. The embeddable shipping-quote widget puts a live delivered price on a vehicle detail page or a buyer portal. And the Carpool customer portal handles everything by hand. Most groups start with the extension or the portal and move order creation to the API once volume justifies it; the webhooks are useful from day one either way.