API reference - Lanesurf Agent API


Base URL	`https://agent.lanesurf.com`
MCP server	`https://agent.lanesurf.com/mcp` (streamable HTTP). See Connect over MCP
Auth	`Authorization: Bearer ls_live_…` on every route except signup and `/health`. See API keys
Format	JSON in, JSON out. Request bodies up to 1 MB
Contract	`/openapi.yaml`, OpenAPI 3.1
Version	`/v1` in the path. See Versioning and the changelog
Limits	Up to 120 requests per minute per key, counted on each Lanesurf server, so treat it as the most to send. See Rate limits

Broker keys can’t call /v1/carrier/* and carrier keys can’t call /v1/loads/* (403 wrong_role). Routes marked verified need a verified carrier key (403 verification_required otherwise).

Method and path	MCP tool	Key	What it does
`POST /v1/signup`	`start_signup`	none	Start signup as a carrier or a brokerage; emails an 8-digit code
`POST /v1/signup/{signup_id}/verify`	`verify_signup`	none	Finish signup with the code; returns the API key once
`GET /v1/me`	`whoami`	any	Who this key belongs to: role, and a carrier’s verification
`GET /health`		none	`{"status": "ok"}` when the service is up

Brokers

Method and path	MCP tool	Key	What it does
`GET /v1/loads`	`list_loads`	broker	Your brokerage’s loads posted through the API, newest first, a page at a time
`POST /v1/loads`	`post_load`	broker	Post a load as JSON fields; Lanesurf starts finding carriers. Needs `Idempotency-Key`
`GET /v1/loads/{id}`	`get_load`	broker	Load status and carrier offers
`GET /v1/loads/{id}/outreach`	`load_outreach`	broker	Which carriers Lanesurf contacted on the load
`POST /v1/loads/{id}/offers/{session_id}/accept`	`accept_offer`	broker	Accept a carrier’s offer at the rate the person agreed to
`POST /v1/loads/{id}/offers/{session_id}/decline`	`decline_offer`	broker	Record that the rep passes on an offer
`POST /v1/loads/{id}/covered`	`mark_covered`	broker	The rep covered it elsewhere; Lanesurf stops
`GET /v1/broker/setup`	`get_broker_setup`	broker	What Lanesurf’s agents tell carriers about the brokerage, and whether outreach is on
`PATCH /v1/broker/setup`	`update_broker_setup`	broker	Change that setup

Carriers

Method and path	MCP tool	Key	What it does
`POST /v1/carrier/trucks`	`post_truck`	carrier	Post an available truck: where, when, equipment, where it wants to go
`GET /v1/carrier/trucks`	`list_trucks`	carrier	List my trucks
`GET /v1/carrier/trucks/{truck_id}`	`get_truck`	carrier	One truck
`PATCH /v1/carrier/trucks/{truck_id}`	`update_truck`	carrier	Update a truck
`DELETE /v1/carrier/trucks/{truck_id}`	`remove_truck`	carrier	Take a truck down
`GET /v1/carrier/trucks/{truck_id}/matches`	`truck_matches`	verified	Loads that fit this truck, closest first
`POST /v1/carrier/lanes`	`save_lane`	carrier	Save a lane the carrier runs
`GET /v1/carrier/lanes`	`list_lanes`	carrier	List my lanes
`DELETE /v1/carrier/lanes/{lane_id}`	`remove_lane`	carrier	Remove a lane
`GET /v1/carrier/loads/search`	`search_loads`	verified	Search loads near a ZIP or city, or by state
`GET /v1/carrier/loads/{load_id}`	`get_carrier_load`	verified	One load’s details, without broker identity or contacts
`POST /v1/carrier/loads/{load_id}/bids`	`bid_on_load`	verified	Bid on a load; bidding again updates the bid
`GET /v1/carrier/bids`	`list_bids`	carrier	My bids and their status
`GET /v1/carrier/outreach`	`my_outreach`	verified	Loads Lanesurf contacted this carrier about in the last 30 days

Lists

Your loads (GET /v1/loads) come a page at a time: limit (1 to 100, default 25), then send next_cursor back as cursor until it is null. Load search and truck matches take limit (1 to 100, default 25) and return the closest loads first, with total, the number returned. There is no offset or cursor: narrow or change the search to see other loads. The other lists have no paging and return your newest items up to a cap: trucks 200, lanes 500, bids 200, and carrier outreach 50 loads. A load’s outreach lists every carrier on that load.

Errors

Every error is JSON with a stable code to branch on and a request_id to quote to support:

{ "error": "too many requests for this API key; slow down", "code": "rate_limited", "request_id": "req_…" }

Some errors add missing, current_rate or next_step. See Errors for every code and what to do, and Idempotency and retries for when to retry.

Discovery files

File	What
`/openapi.yaml`	The full contract
`/llms.txt`, `/llms-full.txt`	This site as Markdown, for agents. Add `.md` to any page URL for its Markdown
`https://agent.lanesurf.com/.well-known/oauth-authorization-server`	OAuth metadata for AI apps that sign in
`https://agent.lanesurf.com/.well-known/oauth-protected-resource/mcp`	Which sign-in server protects `/mcp`
`https://agent.lanesurf.com/.well-known/api-catalog`	The API catalog (RFC 9727): links to this contract, these docs and the health check
`https://agent.lanesurf.com/.well-known/mcp/server-card.json`	The MCP server card: name, endpoint and how to authenticate

​Signup and keys

​Brokers

​Carriers

​Lists

​Errors

​Discovery files

Signup and keys

Brokers

Carriers

Lists

Errors

Discovery files