Skip to content
Last updated

Pricing API Overview

Introduction

The EchoSync Pricing API enables you to request freight quotes for truckload (TL) shipments. The API provides pricing, transit times, and service options for your shipping needs.

Base URL

Production: https://customerapi.echo.com

Authentication

The API supports two authentication methods:

OAuth 2.0

Recommended

To access this API, you first need to generate an Access Token using your unique Client Credentials:

  1. Request a Token: Use your Client ID and Client Secret at Authorization Server: https://auth.echo.com - (See: Full Auth API Documentation).
  2. Get the Token: The server will provide a unique Access Token
  3. Use the Token: Add this token to your request headers as:
    Authorization: Bearer {your_token}

Token Lifecycle:

  • Tokens expire after 10 hours
  • Reuse tokens until expiration to avoid rate limiting
  • Request a new token only after the current one expires

Basic Authentication

Alternatively, use Basic Authentication with Base64-encoded credentials:

Authorization: Basic {base64(client_id:client_secret)}

Rate Limits

  • API Requests: Maximum 3 requests per second
  • Token Requests: Please request a new token only if the current one is approaching expiration. To maintain system stability, avoid requesting multiple tokens if a fresh one was recently generated. Specifically, do not request new tokens multiple times per hour.

Note: Exceeding these limits may result in rate limiting or temporary access suspension.

Core Concepts

Service Modes

  • Truckload (TL): Shipment requiring the entirely of a trailer's available space.
  • Partial (PL): Shipments requiring only a portion of a full truckload shipment and requires detailed freight specifications to accurately quote.

Quote Status

  • Pending: Quote visible internally only, does not expire
  • Open: Quote finalized and available for customer booking