{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-carrier-api/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Carrier API Overview"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"carrier-api-overview","__idx":0},"children":["Carrier API Overview"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"introduction","__idx":1},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Echo Carrier API enables carriers to search available truckload shipments, place bids, and book loads directly through Echo Global Logistics. The API provides real-time access to load availability with pricing and route details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"base-url","__idx":2},"children":["Base URL"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Production:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://carrierapi.echo.com"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"authentication","__idx":3},"children":["Authentication"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Carrier API uses ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OAuth 2.0"]}," exclusively. Use the Client Credentials flow to obtain a Bearer token via the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/authorizer-api/introduction"},"children":["EchoSync Authorizer API"]},":"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call the authentication endpoint with your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_secret"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Receive an access token valid for 3 hours"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Include the token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bearer {access_token}"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reuse tokens until expiration and request a new token only after the current one expires."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Two scopes are used depending on the operation:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Scope"},"children":["Scope"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Operations"},"children":["Operations"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["loads_read"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Search available loads"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["loads_action"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Place bids and bookings"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"core-features","__idx":4},"children":["Core Features"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"available-loads","__idx":5},"children":["Available Loads"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Search Echo's load board using flexible criteria including origin/destination, equipment type, pickup date, distance, weight, and special services. Results are paginated."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"bidding","__idx":6},"children":["Bidding"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit a bid on an available load with a bid amount and contact information. A successful bid returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truckloadBidKey"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"booking","__idx":7},"children":["Booking"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Book an available load directly at a specified rate. Requires load ID, booking amount, contact details, empty city, and equipment type. A successful booking returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["truckloadBookingKey"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"v1-vs-v2-available-loads","__idx":8},"children":["V1 vs V2 Available Loads"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both versions accept identical request parameters. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["V2 is recommended"]}," for all new integrations."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["V2 (recommended):"]}," Returns full load details plus an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["echoDriveDeepLink"]}," — a URL to view, bid on, or book the load directly in the EchoDrive web portal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["V1 (legacy):"]}," Returns full load details with rates only"]}]}]},"headings":[{"value":"Carrier API Overview","id":"carrier-api-overview","depth":1},{"value":"Introduction","id":"introduction","depth":2},{"value":"Base URL","id":"base-url","depth":2},{"value":"Authentication","id":"authentication","depth":2},{"value":"Core Features","id":"core-features","depth":2},{"value":"Available Loads","id":"available-loads","depth":3},{"value":"Bidding","id":"bidding","depth":3},{"value":"Booking","id":"booking","depth":3},{"value":"V1 vs V2 Available Loads","id":"v1-vs-v2-available-loads","depth":3}],"frontmatter":{"id":"introduction","title":"Carrier API Introduction","seo":{"title":"Carrier API Overview"}},"lastModified":"2026-06-23T21:43:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/carrier-api/introduction","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}