Envia Geocodes API – Overview

The Geocodes API (also known as Address Validation API) provides geocoding and address validation services. Use it to validate zip codes and locate cities to ensure accurate address information for shipping operations.

What you can do with the Geocodes API

• Validate Zip Codes

  • Verify if a postal or zip code is valid for a selected country
  • Get complete location details including city, state, and neighborhoods
  • Auto-complete address forms with accurate data

• Locate Cities

  • Find city information by country and city name
  • Get state codes, zip codes, and GPS coordinates
  • Support location-based workflows and address validation

What you can do

Environments & Authentication

• Production: https://geocodes.envia.com/
• Sandbox/Test: https://geocodes-test.envia.com/

Auth: Same Bearer token you use for the Shipping API. In your MPI (Envia dashboard), go to Developers to generate/manage tokens. Include it in every request via Authorization: Bearer <token>.

Use Cases

• Address Validation: Verify zip codes and get complete location information before creating shipments
• Auto-completion: Provide city suggestions and auto-fill address forms based on partial input
• Shipping Forms: Ensure accurate address data for shipping labels and reduce failed deliveries
• Geocoding: Get GPS coordinates for mapping and distance calculations

When to use Geocodes vs. Queries vs. Shipping

• Use Geocodes when you need to validate zip codes or locate cities by name
• Use Queries when you need to discover carrier/service availability, reference data (countries, states, cities), or account resources
• Use Shipping when you need to execute shipping operations (rate, label, track, pickup, cancel)

A typical flow:

1. Validate Address (Geocodes): validate zip code → locate city if needed
2. Discover Options (Queries): check available carriers/services for the validated location
3. Execute (Shipping): request rates → choose service → create label → schedule pickup

🛟

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.