Skip to main content
GET
Search loads near a ZIP or city, or by state
Active loads from Lanesurf brokers that show their loads to carriers. Give origin_zip (best), origin_city with origin_state, origin_state, or destination_state; a search with none answers 400. Near a ZIP or city (origin_zip, or origin_city + origin_state), loads come closest first:
  1. same ZIP (match: same_zip),
  2. within 50, 100 and 150 miles (within_50_miles, within_100_miles, within_150_miles),
  3. anywhere else in the same state (same_state).
Each load has deadhead_miles: straight-line miles from the ZIP or city to the pickup (left out when the pickup can’t be placed). An unknown origin_zip answers 400 unless origin_state is also given. By state (origin_state alone): that state’s pickups, newest first.
  • destination_city matches the last delivery exactly (any letter case).
  • equipment_type matches when the load’s equipment contains it (e.g. Reefer).
  • pickup_date (YYYY-MM-DD) is one day; pickup_from / pickup_to give a range and win over pickup_date.
  • total is the number of loads returned.
Results never include the broker’s name, contacts or max rate. posted_rate is shown only when the broker priced the load (rate_type: priced). To go for a load, bid on it with POST /v1/carrier/loads/{load_id}/bids. Only verified carriers can search (403 verification_required).

Authorizations

Authorization
string
header
required

One key per broker rep or per carrier signup. Keep it secret.

Query Parameters

origin_zip
string

5-digit ZIP where the truck is. Ranks loads near it.

Pattern: ^[0-9]{5}$
Example:

"79901"

origin_state
string

2-letter state. With origin_city: loads near the city. Alone: that state's pickups.

Required string length: 2
Example:

"TX"

origin_city
string

Where the truck is, with origin_state. Ranks loads near it; a city we can't place matches only that exact city.

Example:

"Dallas"

destination_state
string

2-letter delivery state.

Required string length: 2
Example:

"GA"

destination_city
string

Last delivery city (exact, any case).

equipment_type
string

Matches loads whose equipment contains this text.

Example:

"Reefer"

pickup_date
string<date>

One pickup day (YYYY-MM-DD).

pickup_from
string<date>

Earliest pickup day (YYYY-MM-DD). Wins over pickup_date.

pickup_to
string<date>

Latest pickup day (YYYY-MM-DD). Wins over pickup_date. Before pickup_from answers 400.

limit
integer
default:25

How many loads to return, a whole number from 1 to 100. Defaults to 25. Anything else answers 400.

Required range: 1 <= x <= 100

Response

Matching loads.

loads
object[]
required
total
integer
required

The number of loads in this answer.