---
updatedAt: 2026-09-01T22:19:43.000Z
agentTools:
  projectIndex: https://docs.envia.com/llms.txt
---

# Introduction

## Welcome to Shipping Envia API!

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:

<Cards>
  <Card title="Shipping API" href="/docs/envia-shipping-api-introduction" icon="fa-truck">
    Your primary interface for executing shipping operations. Get rates, create labels, track packages, schedule pickups, cancel shipments, generate manifests, and create commercial invoices.
  </Card>

  <Card title="Queries API" href="/docs/queries-api-overview" icon="fa-search">
    A read-only API for discovery, validation, and operational insights. Look up carrier availability, validate addresses, retrieve reference data, and fetch shipment history.
  </Card>

  <Card title="Geocodes API" href="/docs/geocodes-api-overview" icon="fa-map-marker-alt">
    Provides geocoding and postal code validation. Validate zip codes, locate cities, and ensure address accuracy before shipping to reduce failed deliveries.
  </Card>
</Cards>

## Environments

Envia provides two environments for development and production:

| Service          | Base URLs                                                                                        |
| :--------------- | :----------------------------------------------------------------------------------------------- |
| **Shipping API** | **Sandbox**: `https://api-test.envia.com/`<br />**Production:** `https://api.envia.com/`         |
| **Queries API**  | **Sandbox**: `https://queries.test.envia.com/`<br />**Production**: `https://queries.envia.com/` |
| **Geocodes API** | `https://geocodes.envia.com/`                                                                    |

## Global presence

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

<HTMLBlock>{`
<div class="CardsGrid" style="--CardsGrid-cardWidth: 120px; --CardsGrid-columns: 6;">
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Argentina</h3>
            <img src="https://shipping.envia.com/flags/ar.svg" alt="Bandera de Argentina" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Brazil</h3>
            <img src="https://shipping.envia.com/flags/br.svg" alt="Bandera de Brazil" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Canada</h3>
            <img src="https://shipping.envia.com/flags/ca.svg" alt="Bandera de Canada" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Chile</h3>
            <img src="https://shipping.envia.com/flags/cl.svg" alt="Bandera de Chile" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Colombia</h3>
            <img src="https://shipping.envia.com/flags/co.svg" alt="Bandera de Colombia" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Spain</h3>
            <img src="https://shipping.envia.com/flags/es.svg" alt="Bandera de Spain" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">France</h3>
            <img src="https://shipping.envia.com/flags/fr.svg" alt="Bandera de France" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Guatemala</h3>
            <img src="https://shipping.envia.com/flags/gt.svg" alt="Bandera de Guatemala" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">India</h3>
            <img src="https://shipping.envia.com/flags/in.svg" alt="Bandera de India" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Italy</h3>
            <img src="https://shipping.envia.com/flags/it.svg" alt="Bandera de Italy" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">Mexico</h3>
            <img src="https://shipping.envia.com/flags/mx.svg" alt="Bandera de Mexico" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
    <div class="readme-tailwind">
        <div class="flex flex-col items-center justify-center gap-y-1 p-2 h-full">
            <h3 class="font-semibold text-center text-xs text-slate-600 dark:text-slate-300 min-h-[32px] flex items-center justify-center">USA</h3>
            <img src="https://shipping.envia.com/flags/us.svg" alt="Bandera de USA" class="max-w-[55%] h-auto rounded-md">
        </div>
    </div>
</div>
`}</HTMLBlock>

## Typical integration flow

Most shipping workflows follow this pattern:

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

## What are you building?

Choose the path that best describes your project. Each guide is tailored with the specific endpoints, examples, and best practices you need.

<Tabs>

  <Tab title="E-commerce">

**You're adding shipping to an online store — rates at checkout, labels after payment.**

1. [Authentication](https://docs.envia.com/docs/authentication) — Get your API keys
2. [E-commerce Checkout Guide](https://docs.envia.com/docs/ecommerce-checkout) — Full walkthrough for cart integration
3. [Webhooks Guide](https://docs.envia.com/docs/webhooks) — Get real-time tracking updates for your customers
4. [Production Checklist](https://docs.envia.com/docs/production-checklist) — Go live with confidence

  </Tab>

  <Tab title="Marketplace">

**You manage multiple sellers who ship from different locations with different carriers.**

1. [Authentication](https://docs.envia.com/docs/authentication) — Get your API keys
2. [Marketplace Guide](https://docs.envia.com/docs/marketplace-multi-seller) — Multi-seller shipping architecture
3. [Webhooks Guide](https://docs.envia.com/docs/webhooks) — Route tracking events to the right seller
4. [Production Checklist](https://docs.envia.com/docs/production-checklist) — Go live with confidence

  </Tab>

  <Tab title="Warehouse / 3PL">

**You process high volumes — batch labels, daily manifests, scheduled pickups.**

1. [Authentication](https://docs.envia.com/docs/authentication) — Get your API keys
2. [Warehouse & 3PL Guide](https://docs.envia.com/docs/warehouse-3pl) — Batch processing and automation
3. [Webhooks Guide](https://docs.envia.com/docs/webhooks) — Automated status updates
4. [Production Checklist](https://docs.envia.com/docs/production-checklist) — Go live with confidence

  </Tab>

  <Tab title="AI / MCP">

**You want to use Envia from AI assistants like Claude, Cursor, or VS Code.**

1. [MCP Server Guide](https://docs.envia.com/docs/mcp-overview) — Setup and configuration
2. [Authentication](https://docs.envia.com/docs/authentication) — Get your API key for the MCP server

  </Tab>
</Tabs>

Or follow the complete [Integration Guide](https://docs.envia.com/docs/integration-guide) for a step-by-step path from setup to production.

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.

<Callout icon="🛟" theme="default">
  ### Need Help?

  Have questions or need assistance with your integration?<br />Our support team is ready to help 🚀

  **[Create a support ticket here](https://envia.atlassian.net/servicedesk/customer/portal/3/group/3/create/10611)** and we’ll guide you with setup, troubleshooting, or feature requests.
</Callout>

<br />