# Lanesurf Agent API

> Let any AI agent get a freight load covered, or get a truck loaded, through Lanesurf.

> ## Agent Instructions
> You are reading the Lanesurf Agent API docs. Start with /for-ai-agents.md for the rules an agent must follow.
> The API is at https://agent.lanesurf.com and the MCP server at https://agent.lanesurf.com/mcp. Lanesurf doesn't send webhooks: poll.
> Limits: /rate-limits.md. Keys: /api-keys.md. Safe retries: /idempotency.md. Every route on one page: /api-reference.md.
> Always confirm with the person before accepting a carrier offer or bidding on a load. Never reveal an API key, and never show broker contact details to a carrier.
> The full contract is at /openapi.yaml.
> Sign up with POST /v1/signup (carrier or broker, a work email, an MC and/or DOT number), then POST /v1/signup/{signup_id}/verify. Follow next_step on every signup answer.

- [Lanesurf Agent API](https://docs.lanesurf.com/index.md): Get a freight load covered, or get a truck loaded, from any AI agent.
- [Instructions for AI agents](https://docs.lanesurf.com/for-ai-agents.md): The rules an AI agent follows when it uses Lanesurf for a freight broker or a carrier.
- [Authentication](https://docs.lanesurf.com/authentication.md): Sign up as a carrier or a brokerage with a work email, an MC or DOT number and an 8-digit code, then send the key on every request.
- [API keys](https://docs.lanesurf.com/api-keys.md): How to get a Lanesurf API key, send it, keep it safe, replace it and revoke it.
- [Connect over MCP](https://docs.lanesurf.com/agents/mcp.md): Use Lanesurf as tools in Claude, Cursor, Grok and other MCP clients.
- [Use plain HTTP](https://docs.lanesurf.com/agents/http.md): Any agent or script that can make HTTP requests can use Lanesurf.
- [Sign up your brokerage](https://docs.lanesurf.com/brokers/get-a-key.md): Get a broker API key yourself with your MC or DOT number, your work email and an 8-digit code.
- [Cover a load](https://docs.lanesurf.com/brokers/cover-a-load.md): Post a load as JSON fields. Lanesurf reaches carriers and brings back offers with rates.
- [Load status and offers](https://docs.lanesurf.com/brokers/load-status.md): Read carrier offers, then accept one, decline one, or stop.
- [Manage a load](https://docs.lanesurf.com/brokers/manage-a-load.md): Edit, pause, resume, reopen or delete a load you posted.
- [Start signup](https://docs.lanesurf.com/api-reference/authentication/start-signup-carrier-or-broker.md): Say carrier or broker, give an MC and/or DOT number and a work email. We email a code.
- [Verify the code](https://docs.lanesurf.com/api-reference/authentication/finish-signup-with-the-code.md): Send the 8-digit code (brokers also say who they are). Get your API key.
- [Get brokerage setup](https://docs.lanesurf.com/api-reference/broker-setup/your-brokerages-setup.md): What Lanesurf's agents tell carriers about your brokerage, and whether outreach is on.
- [Update brokerage setup](https://docs.lanesurf.com/api-reference/broker-setup/change-your-brokerages-setup.md): Change company name, working hours, payment terms, CC emails, ask_first_pricing or carrier visibility.
- [Who am I](https://docs.lanesurf.com/api-reference/authentication/who-this-key-belongs-to.md): See who this API key belongs to.
- [List your loads](https://docs.lanesurf.com/api-reference/broker-loads/list-your-loads.md): The loads your brokerage posted through the API, newest first, a page at a time.
- [Post a load](https://docs.lanesurf.com/api-reference/broker-loads/post-a-load.md): Send a load as JSON fields. Lanesurf starts finding carriers.
- [Get load status](https://docs.lanesurf.com/api-reference/broker-loads/load-status-and-carrier-offers.md): Status, carrier offers and the agreed rate.
- [Edit a load](https://docs.lanesurf.com/api-reference/broker-loads/edit-a-load.md): Change what was posted, as the dashboard can.
- [Delete a load](https://docs.lanesurf.com/api-reference/broker-loads/delete-a-load.md): The shipper cancelled it.
- [Load outreach](https://docs.lanesurf.com/api-reference/broker-loads/who-was-contacted-on-a-load.md): Every carrier on a load, as the dashboard lists them.
- [Accept an offer](https://docs.lanesurf.com/api-reference/broker-loads/accept-a-carriers-offer.md): Pick this carrier. Lanesurf stops looking.
- [Decline an offer](https://docs.lanesurf.com/api-reference/broker-loads/decline-a-carriers-offer.md): Record that the rep passes on this offer.
- [Mark covered](https://docs.lanesurf.com/api-reference/broker-loads/mark-the-load-covered-elsewhere.md): You covered it elsewhere. Lanesurf stops.
- [Pause a load](https://docs.lanesurf.com/api-reference/broker-loads/pause-a-load.md): Stop sourcing a load on hold; resume it later.
- [Resume a load](https://docs.lanesurf.com/api-reference/broker-loads/resume-a-load.md): Put a paused load back on the market.
- [Reopen a covered load](https://docs.lanesurf.com/api-reference/broker-loads/reopen-a-covered-load.md): The carrier fell off: look for a carrier again.
- [Sign up](https://docs.lanesurf.com/carriers/sign-up.md): Get a carrier API key with your MC or DOT number, your work email and an 8-digit code. No one at Lanesurf involved.
- [Get your truck loaded](https://docs.lanesurf.com/carriers/find-a-load.md): For carriers and dispatchers: post your truck, search loads, and bid on the ones you want to run.
- [Post a truck](https://docs.lanesurf.com/carriers/post-a-truck.md): Tell Lanesurf where your truck is, when it's free, and where it wants to go.
- [Save your lanes](https://docs.lanesurf.com/carriers/lanes.md): Tell Lanesurf the lanes your carrier runs: its terminals.
- [Bid on a load](https://docs.lanesurf.com/carriers/bid-on-a-load.md): Tell the broker you want to run a load. The broker's team follows up with your dispatcher.
- [Start signup](https://docs.lanesurf.com/api-reference/authentication/start-signup-carrier-or-broker.md): Say carrier or broker, give an MC and/or DOT number and a work email. We email a code.
- [Verify the code](https://docs.lanesurf.com/api-reference/authentication/finish-signup-with-the-code.md): Send the 8-digit code (brokers also say who they are). Get your API key.
- [Who am I](https://docs.lanesurf.com/api-reference/authentication/who-this-key-belongs-to.md): See who this API key belongs to.
- [Post a truck](https://docs.lanesurf.com/api-reference/carrier-trucks/post-an-available-truck.md): Say where a truck is, when it's free, and where it wants to go.
- [List my trucks](https://docs.lanesurf.com/api-reference/carrier-trucks/list-my-trucks.md): Your posted trucks, newest first.
- [Get a truck](https://docs.lanesurf.com/api-reference/carrier-trucks/get-a-truck.md): One of your trucks, in any status.
- [Update a truck](https://docs.lanesurf.com/api-reference/carrier-trucks/update-a-truck.md): Change a truck's location, dates or details.
- [Remove a truck](https://docs.lanesurf.com/api-reference/carrier-trucks/remove-a-truck.md): The truck got loaded or isn't available.
- [Loads for a truck](https://docs.lanesurf.com/api-reference/carrier-loads/loads-that-fit-this-truck.md): Loads that fit one of your posted trucks.
- [Save a lane](https://docs.lanesurf.com/api-reference/carrier-lanes/save-a-lane.md): Save a lane the carrier runs.
- [List my lanes](https://docs.lanesurf.com/api-reference/carrier-lanes/list-my-lanes.md): Your saved lanes, newest first.
- [Remove a lane](https://docs.lanesurf.com/api-reference/carrier-lanes/remove-a-lane.md): The carrier no longer runs this lane.
- [Search loads](https://docs.lanesurf.com/api-reference/carrier-loads/search-loads-near-a-zip-or-city-or-by-state.md): Find loads near a ZIP or city, or by state, equipment and pickup date.
- [Get a load](https://docs.lanesurf.com/api-reference/carrier-loads/one-loads-details.md): One load's details, without broker identity or contacts.
- [Bid on a load](https://docs.lanesurf.com/api-reference/carrier-loads/bid-on-a-load.md): Tell the broker you want to run this load.
- [My bids](https://docs.lanesurf.com/api-reference/carrier-loads/my-bids-and-their-status.md): Your bids and where each one stands.
- [My outreach](https://docs.lanesurf.com/api-reference/carrier-loads/lanesurf-outreach-i-received.md): The loads Lanesurf contacted you about in the last 30 days.
- [API reference](https://docs.lanesurf.com/api-reference.md): Every Lanesurf Agent API route and MCP tool on one page: base URL, auth, roles, errors and the OpenAPI contract.
- [Errors](https://docs.lanesurf.com/errors.md): Every error code the API returns, its HTTP status, and what your agent should do next.
- [Statuses](https://docs.lanesurf.com/statuses.md): What every load, offer, truck, bid and carrier verification status means, in one place.
- [Rate limits](https://docs.lanesurf.com/rate-limits.md): How many requests Lanesurf allows, what a 429 looks like, and how an agent should back off.
- [Idempotency and retries](https://docs.lanesurf.com/idempotency.md): Which calls are safe to send twice, how Idempotency-Key works, and how to retry after an error.
- [Versioning](https://docs.lanesurf.com/versioning.md): How the Lanesurf Agent API is versioned, what counts as a breaking change, and how changes are announced.
- [Changelog](https://docs.lanesurf.com/changelog.md): What's new in the Lanesurf Agent API, newest first.

## OpenAPI Specs

- [openapi](/openapi.yaml)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.