CarHauler247 API v2 Documentation

🔑 How v2 Differs From v1

v2 returns the exact same quote data as API v1, but adds authentication and metering so it can support paid, high-volume usage:

	v1	v2
Authentication	None	Bearer API key
Rate limit	Per-IP, low ceiling	None (billed by volume instead)
CORS	Enabled (browser-callable)	Disabled (server-to-server only)
Cost	Free	Free tier, then pay-per-call

Get a key at carhauler247.com/apiClient/keys - includes a free lifetime allowance before any charges apply.

🔐 Authentication

Every request must include your API key as a Bearer token:

Authorization: Bearer ch247_your_api_key_here

Requests without a valid, active key receive:

401 Unauthorized
{
  "error": "Missing or invalid API key. Include 'Authorization: Bearer <key>'. Get a key at https://carhauler247.com/apiClient/keys"
}
        

Once your free calls are used up, further calls receive:

402 Payment Required
{
  "error": "Free usage limit reached. Contact us to set up billing and continue making calls."
}
        

Because the Bearer key is a billing secret, keep it server-side - never embed it in client-side/browser JavaScript.

📡 Endpoints

Get a Quote

GET https://carhauler247.com/api/public/v2/quote

POST https://carhauler247.com/api/public/v2/quote

Parameter	Type	Required	Description
`fromZip`	integer	Yes	Origin ZIP code (5 digits)
`toZip`	integer	Yes	Destination ZIP code (5 digits)
`vehicleType`	string	No	Vehicle type: `sedan`, `suv`, `pickup`, `truck`, `van`, `minivan` (default: sedan)
`isOperational`	boolean	No	Whether vehicle runs and drives (default: true)

Example Request

curl "https://carhauler247.com/api/public/v2/quote?fromZip=90001&toZip=10001&vehicleType=sedan" \
  -H "Authorization: Bearer ch247_your_api_key_here"
        

Example Response 200 OK

Trimmed down from v1's response - no message on success, no company, and no quote.from/quote.to:

{
  "success": true,
  "quote": {
    "price": 1189,
    "distance": 2796,
    "estimatedDays": "2796 miles, 4 days and 7 hours drive",
    "vehicleType": "sedan",
    "carrier": "open",
    "operational": true
  }
}
        

Search ZIP Codes

GET https://carhauler247.com/api/public/v2/zipcode/search

Parameter	Type	Required	Description
`zipPrefix`	string	Yes	3-5 digit ZIP code prefix, e.g. `900`

GET /api/public/v2/zipcode/search?zipPrefix=900
→ Returns up to 8 matching cities, largest population first
        

💰 Pricing

New API clients get a free lifetime allowance of calls before any billing applies - plenty to build and test an integration. After that, calls are billed per request with volume discounts as your usage grows.

View Full Pricing

🚀 Get Started

Create an account and generate your API key - no payment info required to start.

Get Your API Key View API v1 Docs

📞 Contact & Support

Phone: (408) 256-0371

Email: dispatch@carhauler247.com

For integration questions, higher volume needs, or partnership inquiries, please contact us.