{"openapi":"3.1.0","info":{"title":"Warp Freight API","version":"1.0.0","description":"Public freight data APIs from Warp. Access LTL rate comparisons across 568+ lanes and 36 carriers, or ask natural language freight questions. No authentication required.","contact":{"name":"Warp","url":"https://www.wearewarp.com","email":"support@wearewarp.com"},"license":{"name":"Proprietary","url":"https://www.wearewarp.com/terms"}},"servers":[{"url":"https://www.wearewarp.com","description":"Production"}],"paths":{"/api/ltl-rates":{"get":{"operationId":"getLtlRates","summary":"Get LTL freight rate comparisons","description":"Returns LTL rate data across 568+ lanes with Warp rates and 10-12 competing carrier rates per lane. Query by lane, origin, or destination. Includes rate history, transit times, and SCAC codes.","parameters":[{"name":"lane","in":"query","description":"Specific lane slug (e.g., \"atlanta-to-chicago\")","schema":{"type":"string"},"example":"atlanta-to-chicago"},{"name":"origin","in":"query","description":"Filter by origin city (e.g., \"atlanta\")","schema":{"type":"string"},"example":"atlanta"},{"name":"destination","in":"query","description":"Filter by destination city (e.g., \"chicago\")","schema":{"type":"string"},"example":"chicago"},{"name":"cheapest","in":"query","description":"If \"true\", return only lanes where Warp is the cheapest carrier","schema":{"type":"string","enum":["true","false"]}},{"name":"limit","in":"query","description":"Max results to return (default 50, max 200)","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"Rate data","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/SingleLaneResponse"},{"$ref":"#/components/schemas/MultiLaneResponse"}]},"examples":{"singleLane":{"summary":"Single lane lookup","value":{"lane":"atlanta-to-chicago","origin":"Atlanta","destination":"Chicago","warp":{"rate":905.25,"transit_days":3,"all_inclusive":true,"fuel_surcharge":0,"accessorials":0},"carrier_count":12,"carrier_average_rate":1200,"warp_is_cheapest":true,"savings_vs_average":"24%","basis":"4 pallets, 4,800 lbs, class 70","updated":"March 2026"}}}}}}}}},"/api/freight-answer":{"get":{"operationId":"getFreightAnswer","summary":"Ask a natural language freight question","description":"Natural language Q&A endpoint for freight questions. Returns structured answers with data and sources. No authentication required.","parameters":[{"name":"q","in":"query","required":true,"description":"The freight question to answer","schema":{"type":"string"},"example":"How much does LTL cost from Atlanta to Chicago?"}],"responses":{"200":{"description":"Structured answer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreightAnswerResponse"}}}}}},"post":{"operationId":"postFreightAnswer","summary":"Ask a natural language freight question (POST)","description":"Same as GET but accepts question in request body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["question"],"properties":{"question":{"type":"string","description":"The freight question to answer","example":"How much does LTL cost from Atlanta to Chicago?"}}}}}},"responses":{"200":{"description":"Structured answer","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FreightAnswerResponse"}}}}}}}},"components":{"schemas":{"SingleLaneResponse":{"type":"object","properties":{"lane":{"type":"string"},"origin":{"type":"string"},"destination":{"type":"string"},"warp":{"type":"object","properties":{"rate":{"type":"number"},"transit_days":{"type":"integer"},"all_inclusive":{"type":"boolean"},"fuel_surcharge":{"type":"number"},"accessorials":{"type":"number"}}},"carrier_count":{"type":"integer"},"carrier_average_rate":{"type":"number"},"cheapest_carrier":{"type":"object","properties":{"name":{"type":"string"},"scac":{"type":"string"},"rate":{"type":"number"},"transit_days":{"type":"integer"}}},"warp_is_cheapest":{"type":"boolean"},"savings_vs_average":{"type":"string"},"all_carriers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"scac":{"type":"string"},"rate":{"type":"number"},"transit_days":{"type":"integer"}}}},"rate_history":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"rate":{"type":"number"}}}},"basis":{"type":"string"},"updated":{"type":"string"}}},"MultiLaneResponse":{"type":"object","properties":{"meta":{"type":"object","properties":{"total_lanes":{"type":"integer"},"returned":{"type":"integer"},"average_warp_rate":{"type":"number"},"average_savings_vs_carriers":{"type":"string"},"basis":{"type":"string"},"updated":{"type":"string"}}},"lanes":{"type":"array","items":{"$ref":"#/components/schemas/SingleLaneResponse"}}}},"FreightAnswerResponse":{"type":"object","properties":{"question":{"type":"string"},"answer":{"type":"string"},"data":{"type":"object"},"sources":{"type":"array","items":{"type":"string"}},"related_questions":{"type":"array","items":{"type":"string"}},"quote_url":{"type":"string"}}}}}}