Introduction to Envia APIs

Envia is a multi-carrier shipping platform that connects your application to 100+ shipping carriers worldwide through a single API integration. Instead of building and maintaining separate integrations with FedEx, DHL, UPS, and dozens of regional carriers, you integrate once with Envia and access them all.

We handle carrier communication, label generation, rate quoting, tracking, and address validation so you can focus on your core product.

The Envia API ecosystem

Envia provides three APIs, each optimized for specific workflows:

Shipping API

Your primary interface for executing shipping operations. Get rates, create labels, track packages, schedule pickups, cancel shipments, generate manifests, and create commercial invoices.

Queries API

A read-only API for discovery, validation, and operational insights. Look up carrier availability, validate addresses, retrieve reference data, and fetch shipment history.

Geocodes API

Provides geocoding and postal code validation. Validate zip codes, locate cities, and ensure address accuracy before shipping to reduce failed deliveries.

Choose your path

Pick the guide that matches what you're building:

Just exploring?

Run the Quickstart to ship your first sandbox package in 3 API calls.

E-commerce checkout

Add real-time shipping rates at checkout and automate label generation after payment.

Marketplace

Enable sellers to ship with any carrier through your platform without managing carrier accounts.

Warehouse / 3PL

Automate high-volume label creation, manifests, and daily pickups.

AI / MCP integration

Use Envia APIs from AI assistants like Claude Desktop, Cursor, or VS Code via MCP.

Or follow the complete Integration Guide for a step-by-step path from setup to production.

How Envia works

Your application communicates with Envia's APIs, which handle all carrier interactions, normalization, and business logic. Envia then routes requests to the appropriate carriers and returns standardized responses.

flowchart LR
  App["Your Application"] --> Envia["Envia APIs"] --> Carriers["100+ Carriers"]
  style Envia fill:#1873dc,color:#fff

This architecture means you:

Integrate once – use consistent schemas and endpoints regardless of carrier
Add carriers easily – new carriers become available without code changes
Reduce complexity – Envia handles carrier-specific formats, authentication, and edge cases
Scale globally – access carriers across 10+ countries from a single platform

Global presence

Envia operates in the following countries, enabling local and international shipping from these locations:

Argentina

Brazil

Canada

Chile

Colombia

Spain

France

Guatemala

India

Italy

Mexico

USA

Typical integration flow

Most shipping workflows follow this pattern:

Validate addresses (Geocodes API) – ensure destination addresses are correct
Discover options (Queries API) – check available carriers and services for the route
Get rates (Shipping API) – request quotes from one or more carriers
Create label (Shipping API) – purchase and download a shipping label
Track shipment (Shipping API or Queries API) – monitor delivery status
Manage operations (Shipping API or Queries API) – schedule pickups, cancel shipments, view history

You don't need all three APIs for every integration. Start with the Shipping API for basic shipping, then add Queries and Geocodes as you need address validation and discovery features.

Getting started

1. Set up authentication

All Envia APIs use the same Bearer token authentication. Generate separate tokens for sandbox and production environments. See Auth & Environments for more information.

2. Build your first shipment

Follow the quickstart guide to quote rates, create a label, and track a shipment in the sandbox environment.

3. Explore the APIs

Once you've completed the quickstart, explore the full capabilities of each API:

Shipping API – Overview | API Reference
Queries API – Overview | API Reference
Geocodes API – Overview | API Reference

4. Go to production

After testing in sandbox, switch to production and start shipping real packages.

Important: Use separate API tokens and webhook URLs for sandbox and production to avoid mixing test and live data.

Environments

Envia provides two environments for development and production:

Environment	Purpose	Base URLs
Sandbox	Testing and development	`https://api-test.envia.com/` (Shipping) `https://queries-test.envia.com/` (Queries) Geocodes: N/A — production only
Production	Live shipping operations	`https://api.envia.com/` (Shipping) `https://queries.envia.com/` (Queries) `https://geocodes.envia.com/` (Geocodes)

Sandbox returns simulated responses and doesn't create real labels or charges. Production creates actual shipments and charges your account. Always use separate API tokens for each environment.

What's next?

New to Envia? Start with the Quickstart to ship your first sandbox package in 3 API calls
Need credentials? Review Auth & Environments to generate API keys
Ready to integrate? Follow the Integration Guide from setup to production
Building for a specific vertical? Check the E-commerce, Marketplace, or Warehouse/3PL guides
Using AI assistants? Connect Envia to your IDE via MCP Server
Going live? Use the Production Readiness Checklist
What changed recently? See the Changelog

🛟
Need Help?
Have questions or need assistance with your integration?
Our support team is ready to help 🚀
Create a support ticket here and we’ll guide you with setup, troubleshooting, or feature requests.