# 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](/authorizer-api/introduction)).
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