canonical: https://jentic.com/apis/e2open.com/e2open-tms # E2open TM-Shippers: Spot Market API The E2open TM-Shippers Spot Market API lets carriers find truckload freight postings and bid on them. Agents can search the Spot Market for available loads, retrieve a load's details along with its supported charge codes and allowed rate bases, and submit basic, detailed, or contract offers. Existing offers can be updated or withdrawn, the full offer history reviewed, and counteroffers answered by updating their status. The API covers Truckload loads only and serves separate North American and European regional hosts. ## For AI agents Search Spot Market truckload postings, create basic, detailed, or contract offers on a load, and update, withdraw, or counter offers. Covers 10 operations for carriers bidding on freight. ## Scope Does not handle shipment tracking, label generation, or less-than-truckload freight. Use for Truckload Spot Market load search and offers only. ## Capabilities - Search the Spot Market for available truckload loads by query - Retrieve a load's details, supported charge codes, and allowed rate bases - Create a basic, detailed, or contract offer on a load - Update or withdraw an existing offer on a load - Review the full offer history for a load - Respond to a counteroffer by updating its status ## Use cases ### AI Agent Freight Bidding Let an AI agent find and bid on truckload freight on behalf of a carrier: it searches the Spot Market for loads on a lane, retrieves a load's supported charge codes and allowed rate bases, and submits a detailed offer. Through Jentic the agent discovers the right E2open operation by intent and calls it with the load id, so bidding runs without a developer wiring the search-and-offer flow by hand. Example prompt: Search the Spot Market for truckload loads on a lane, retrieve a load's charge codes, then create a detailed offer on it ### Offer Management Carriers adjust their bids as market rates move and pull offers that no longer make sense. The API reviews the full offer history for a load, updates the current offer's charges, and withdraws it entirely. This keeps a carrier's active bids current without re-posting from scratch. Example prompt: Retrieve the offer history for a load, update your current offer's rate, then withdraw it if the load is no longer viable ### Counteroffer Handling When a shipper counters a carrier's bid, the carrier responds to keep the negotiation moving. The API fetches the current offer details for a load and updates the status of the counteroffer to accept or reject it. This lets an agent close a freight negotiation that would otherwise sit in a portal. Example prompt: Fetch the current offer details for a load, then update the status of the shipper's counteroffer to accept it ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/` | Search Spot Market loads by query | | GET | `/load/{loadID}/` | Get a specific load | | POST | `/load/{loadID}/offer/` | Create an offer on a load | | GET | `/load/{loadID}/offer/` | Get the offer history for a load | | PUT | `/load/{loadID}/offer/{offerID}` | Update an offer on a load | | DELETE | `/load/{loadID}/offer/{offerID}` | Withdraw an offer from a load | | PUT | `/load/{loadID}/counteroffer/{offerID}` | Update the status of a counteroffer | | GET | `/load/{loadID}/chargecodes` | Get supported charge codes for a load | ## Key resources - **Loads** — Search Spot Market truckload postings and retrieve a load's details, charge codes, and rate bases - **Offers** — Create, read, update, and withdraw basic, detailed, or contract offers on a load - **Counteroffers** — Update the status of a counteroffer on a load to accept or reject it ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 29 / 100 - **Maturity:** Non-Ready - **Dimensions:** - Foundational Compliance: 74 / 100 - Developer Experience & Jentic Compatibility: 71 / 100 - AI-Readiness & Agent Experience: 18 / 100 - Agent Usability: 94 / 100 - Security: 10 / 100 - AI Discoverability: 61 / 100 - **View full report:** https://jentic.com/apis/e2open.com/e2open-tms/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the E2open Spot Market API by hand means handling its basic authentication, picking the right North American or European regional host, and learning its charge-code and rate-basis model per load. Through Jentic you install once, import it from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** E2open puts the load id and offer id in the URL path (`/load/{loadID}/offer/{offerID}`), so a rule can pin your agent to specific loads and the operations you pick. You choose the operations it may call, so searching loads and creating offers can be allowed while withdrawing an offer or answering counteroffers are not included unless you add them. - **Credential handling:** Your E2open basic-auth credentials are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'find truckload loads' or 'make a freight offer', and Jentic returns the matching E2open operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **DAT Freight API** — Freight load board and rate data across the North American truckload market - **AfterShip Shipping API** — Shipment tracking across carriers once a load is in transit - **FedEx Ship API** — Parcel and freight shipping, rating, and labels from a major carrier - **ShipStation API** — Order and fulfillment management that feeds loads into freight planning ## FAQ ### What authentication does the E2open Spot Market API use? The E2open TM-Shippers Spot Market API authenticates with HTTP basic authentication per its OpenAPI spec, so each request carries your username and password. Through Jentic those credentials are stored encrypted by your own Jentic One instance and injected at call time, so they never enter the agent's context. ### Can I submit offers on truckload loads with the E2open Spot Market API? Yes. The create-offer operation submits a basic, detailed, or contract offer on a specific load, where a basic offer carries a single total charge and a detailed offer breaks charges out by code. You can then update, withdraw, or review the history of your offers on that load. ### Does the E2open Spot Market API have regional endpoints? Yes. The API serves separate North American hosts (na-api.tms.e2open.com) and European hosts (tms.eu.e2open.com), along with colour-coded sandbox hosts for testing. Send requests to the host that matches your account's region so loads and offers resolve correctly. ### Is there an E2open Spot Market MCP server? You don't need an MCP server to give your agent the E2open Spot Market API. Jentic connects it directly from the API Directory: import it, store your credentials once, and your agent calls operations like searching loads or creating an offer. Operations are discovered on demand, so no extra server's tool definitions sit in your agent's context. ### Can I limit what my agent is allowed to do with the E2open Spot Market API? Yes. Write a rule that allows only load search and offer creation, so the agent can find loads and bid but cannot withdraw offers or answer counteroffers. Because E2open addresses loads and offers by id in the URL path, a rule can also pin the agent to specific loads, and every call is logged. ### How do I bid on a load with the E2open Spot Market API through Jentic? Search Jentic for 'search spot market truckload loads' to find the search operation, retrieve a load's charge codes and rate bases, then create an offer on it. To run it on your own infrastructure, install Jentic One from its GitHub repo.