The **EnvioXEnvio (ExE) API** allows you to comprehensively manage the quotation and contracting process for transport services for your shipments, both nationally and internationally.

### 📦 Main Features

- **Rates**  
  Create instant rates by indicating origin, destination and cargo characteristics.  
  Query the list of created rates ('GET /rates') or retrieve a specific rate ('GET /rates/{id}').

- **Orders**  
  Create orders from a rate ('POST /orders') or manually with all data.  
  Query all orders or a specific one ('GET /orders', 'GET /orders/{id}').

- **Addresses**  
  Manage reusable addresses for pickup or delivery ('GET', 'POST', 'PUT', 'GET /addresses/{id}').

- **Authentication**  
  All routes require an API key in the header. You can use:
  
  - **Production** environment:
    ```
    x-api-key: YOUR_PRODUCTION_KEY
    ```

  - **Test** environment:
    ```
    test-api-key: YOUR_TEST_KEY
    ```

  > ⚠️ Don't include both in the same request. Use only one.

---

### 🧪 Test Environment (test mode)

Test mode allows you to test all API functionalities without affecting your real data.  
It uses an independent database and allows creating simulated rates, orders and addresses.

To request a test key, contact our team:  
👉 [https://envioxenvio.es/contacto](https://envioxenvio.es/contacto)

---

### 🔧 Data that makes up a rate

Rates are defined by:

- **Origin / Destination**: city, postal code, country (ISO 3166-1 alpha-2 format).  
- **Loads**: units, dimensions (length, width, height), weight, and if it's removable.  
- **Extras**: side loading, lift platform (pickup and delivery), ADR merchandise, non-transferable shipment...

> ℹ️ From version **1.0.1**, it is **no longer necessary to send** the `shipmentType` and `expressVehicleType` fields. They are calculated automatically based on the loads.

**Rate creation example:**

```json
{
  "originPostalCode": "08001",
  "originCountry": "ES",
  "destinationPostalCode": "28001",
  "destinationCountry": "ES",
  "loads": [
    {
      "units": 1,
      "length": 120,
      "width": 100,
      "height": 150,
      "weight": 300,
      "isRemontable": true
    }
  ],
  "pickupTailLift": false,
  "deliveryTailLift": true,
  "isAdr": false,
  "lateralLoad": false,
  "nonTransferable": false,
  "rateType": "rate_by_loads"
}
```

---

### 📘 Version History

- **v1.0.2** *(current — June 26, 2025, 13:31)*  
  - Added support for test mode via `test-api-key`  
  - Documented how to use the test environment without affecting real data  
  - Improved validations and clearer description

- **v1.0.1** *(June 25, 2025, 17:07)*  
  - Removed `shipmentType` and `expressVehicleType` fields from body: now calculated automatically based on loads

- **v1.0.0** *(June 8, 2024, 21:34)*  
  - Initial API version: creation and query of rates, orders and addresses

ExE API

Integrate our API into your system and start enjoying all the advantages that Envio x Envio offers. Instant quotation, shipment management, tracking and much more.

Envio x Envio API - Europe's Digital Freight Forwarder

API Reference

Instant transport contracting throughout Europe

What are you waiting for? It's free and no registration required

Haven't you tried our Instant Rate tool yet?

We adapt to your payment conditions. Pay by direct debit or bank transfer.

EASY PAYMENTS

Let our algorithms and automation work for you, with no margin for error.

EXCELLENT MANAGEMENT

We plant 1 tree for every shipment we make! This is how we offset CO2 emissions.

WE ARE GREEN

Rate any land transport service yourself. No waiting!

INSTANT RATES

We have an extensive network of agreements throughout Europe, Transit companies, Freight forwarders, Agents, Warehouses...

INTERNATIONAL GUARANTEES

Whatever time it is, contract international groupage online, easy, fast and secure.

NO-WAIT CONTRACTING

Delivery documents, CMRs and scanned delivery notes available in your Client Area.

ONLINE DOCUMENTATION

You can check the status and traceability of your shipments with total reliability from your Client Area.

ONLINE TRACKING

All our advantages at your disposal

Get valuable insights through advanced data analysis.

Data Analytics

Bulk Quotations

Access and manage all documentation related to your shipments.

Documentation, CMRs and PODs

Register and manage your cargo orders easily.

Record Cargo Orders

Get real-time rates for your land shipments.

Instant Rates

Track the status and location of your shipments in real time.

Shipment Status and Tracking

Benefits of integrating our API into your system:

Integrate with our instant AI-powered groupage pricing system across Europe.