# General Overview

## Prerequisites

Before you begin integration:

1. **Contact your Echo Account Team** to obtain API credentials (`client_id` and `client_secret`)
2. Ensure your system can make HTTPS REST API calls with JSON payloads
3. Review the OpenAPI specification for complete endpoint details


## API Endpoints

Important
While **`V1`** is still supported for our current users, it is **NO longer available for new onboardings**. To take advantage of enhanced reference handling, all new integrations should use **`V2`**.

The EchoSync Pricing API provides two versions. The functionality is identical, with the exception of a single field name change in the reference number object.

### V2 Endpoints

Recommended
**Base Path:** `/v2/quotes`

| Method | Endpoint | Purpose |
|  --- | --- | --- |
| POST | `/v2/quotes` | Generate a new quote with service options and pricing |
| GET | `/v2/quotes/{id}` | Retrieve an existing quote by `quoteId` or `quoteKey` |


**Reference Number Field:** Uses `referencenumbertype`

**Note:** *Reference Number Type* field name is the only difference between V1 and V2.

### V1 Endpoints

Legacy
details
summary
Click to view V1 Reference Details
**Base Path:** `/v1/quotes`

| Method | Endpoint | Purpose |
|  --- | --- | --- |
| POST | `/v1/quotes` | Generate a new quote with service options and pricing |
| GET | `/v1/quotes/{id}` | Retrieve an existing quote by `quoteId` or `quoteKey` |


**Reference Number Field:** Uses `type`

## Quote Generation Workflow

1. **Submission:** Submit the payload to initiate the request.
2. **Processing:** The system validates data and calculates pricing.
3. **Retrieval:** Return back the `quoteKey` with the final quote details.


For synchronous integrations, the POST response includes service options immediately when available.