Guides

Envia Shipping API – Overview

Welcome to the Envia Shipping API, your all-in-one solution for multi-carrier shipping. This API lets you connect your e-commerce platform or internal system to dozens of local and international carriers through a single integration.

What you can build

With the Shipping API you can:

  • Compare rates across 100+ carriers with a single request per carrier
  • Generate labels and download PDFs ready for printing
  • Track packages in real time from pickup to delivery
  • Schedule pickups, cancel shipments, and create manifests
  • Handle international shipping with commercial invoices and HS code classification

Key Features

  • Multi-carrier – choose from over 100 carriers without maintaining separate integrations.
  • Flexible – ship domestically, internationally, handle returns, and even import shipments.
  • Developer-friendly – consistent JSON schemas, clear documentation, sandbox and production environments, and interactive API explorer.

What you can do

Choose your shipping type to see the relevant workflow:

Ship within the same country — the most common flow.

1. Get a quote

Compare rates across carriers for your route. Each request returns available services, prices, and estimated delivery times.

2. Create a label

Select a rate and purchase a shipping label. You get a tracking number and a downloadable PDF.

3. Track the shipment

Monitor your package in real time from pickup to delivery using the tracking number.

4. Schedule a pickup

Want the carrier to come to you? Schedule a pickup with the tracking numbers and your address.

5. Cancel if needed

Plans changed? Cancel the shipment to void the label and recover your balance.

Environments

We provide two environments so you can develop and test safely before going live:

  • Production: https://api.envia.com/ – live mode that generates real labels and charges.
  • Sandbox / Test: https://api-test.envia.com/ – safe environment to try endpoints and workflows.

Each endpoint page includes an Environment selector so you can switch between these at any time. Make sure you have separate API tokens for each environment.

Core Workflow

  1. Get a quote – call Quote Shipment with origin, destination, and package details.
  2. Create a label – call Create Shipping Label with the chosen carrier and service.
  3. Track – use Track Shipments with the tracking number.
  4. Schedule a pickup (optional) – call Schedule Pickup if you need carrier collection.
  5. Cancel (if needed) – call Cancel Shipment to void the label.

Each endpoint requires a valid bearer token and certain required fields; consult the endpoint's page for parameters, examples, and request/response schemas.

Navigating the Documentation

  • Use the Search bar (press Ctrl+K / ⌘K) to quickly find endpoints or topics.
  • Each endpoint page includes an Environment selector, Authorization panel, Examples dropdown, and an interactive Try It console so you can test calls right in the browser.
  • Check out the Guides section for detailed tutorials and the API Reference for every endpoint with full details.
  • If you're new to the API, start with "Getting Started with Envia API" and "Navigate Through the Documentation" guides.

Authentication

All requests require a bearer token. Create separate tokens for the sandbox and production environments via your Envia dashboard. Include the token in the Authorization: Bearer <token> header for every call. For more information, see the Authentication guide.

Complement Shipping Integration Using the Queries API

The Envia Queries API complements the Shipping API by providing reference data you need before you create shipments. You can use it to fetch lists of countries, states, carriers, services, and pickup options. For example:

  • Get Countries and States: determine which origin countries and states are supported, and retrieve the codes needed for your quote and label requests.
  • Get Available Carriers and Services: discover which carriers and service levels operate in a given country or postal code before quoting shipments.
  • Validate Addresses: ensure that your origin and destination addresses conform to the carrier's requirements in each country.

Refer to the Envia Queries API – Overview guide to learn more about these endpoints and how they enhance your shipping workflows.

With this overview and the endpoint pages, you'll have everything you need to build a seamless multi-carrier shipping experience into your application. Happy shipping!

🛟

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.

What to read next

  • Start coding – The Core Workflow guide walks through every API call with full request/response examples.
  • Plan your integration – The Integration Guide covers all three APIs from address validation to production.
  • Set up webhooks – The Webhooks Guide covers real-time tracking notifications.
  • International shipping? – See Duties & Taxes and HS Codes for customs handling.

Updated 4 days ago