Technical reference

Partner API

Approved dealers, auctions, fleets and broker partners can push orders straight into the TankWorldWide quote pipeline. Each partner receives an API key and an optional outbound webhook URL from the Integrations dashboard.

Endpoint

POST https://www.tankworldwide.com/api/public/partners/orders

Headers

Content-Type: application/json
X-Api-Key: <partner-api-key>

Body (single order)

Send a JSON object with at least originZip and destinationZip.

{
  "originZip": "90210",
  "destinationZip": "10001",
  "category": "vehicle",
  "size": "sedan",
  "operable": true,
  "vehicleCount": 1,
  "transportType": "open",
  "shipDate": "2026-09-15",
  "customerEmail": "customer@example.com",
  "customerPhone": "555-555-0134",
  "partnerReference": "AUCTION-12345"
}

Field	Required	Notes
originZip	required	5-digit US ZIP
destinationZip	required	5-digit US ZIP
category	optional	vehicle, motorcycle, boat, rv, heavy-equipment
size	optional	sedan, suv, truck, oversize
operable	optional	true or false
vehicleCount	optional	1-6
transportType	optional	open or enclosed
shipDate	optional	YYYY-MM-DD
customerEmail	optional	valid email
customerPhone	optional	phone string
partnerReference	optional	your internal ID

Body (batch array)

Send an array of order objects to process multiple orders in one request.

[
  { "originZip": "90210", "destinationZip": "10001", "size": "sedan" },
  { "originZip": "30309", "destinationZip": "60614", "size": "suv", "category": "vehicle" }
]

CSV upload

Send Content-Type: text/csv with a header row. Required columns: originZip, destinationZip.

originZip,destinationZip,category,size,operable,vehicleCount,transportType,shipDate,customerEmail,customerPhone,partnerReference
90210,10001,vehicle,sedan,true,1,open,2026-09-15,customer@example.com,555-555-0134,AUCTION-12345
30309,60614,vehicle,suv,true,1,open,2026-09-15,,,AUCTION-12346

Outbound webhooks

When a partner order is booked or its shipment status changes, TankWorldWide POSTs to the partner webhook URL with X-Tank-Event set to shipment.booked, shipment.picked_up, etc. Signatures use PARTNER_WEBHOOK_SECRET when configured.

Partner API

Need an integration?