Common Endpoints

The Queries API has 80+ endpoints. You won't need most of them on day one. This page covers the endpoints that the majority of integrations use.

Carrier & service discovery

Use these before quoting rates to know which carriers and services are available for a given route.

Get available carriers

Returns carriers that operate in a country.

GET https://queries-test.envia.com/carrier?country_code=MX

When to use: Build a carrier dropdown, or pre-filter before calling the rate endpoint.

Full reference →

Get available services

Returns services filtered by country and carrier.

GET https://queries-test.envia.com/available-service/{country}

When to use: Show service options (ground, express, etc.) after the user selects a carrier.

Full reference →

Address & location data

Use these to build address forms and validate user input.

Get countries

Returns all countries supported by Envia.

GET https://queries-test.envia.com/country

When to use: Populate a country selector in your shipping form.

Full reference →

Get states by country

Returns all states or provinces for a country.

GET https://queries-test.envia.com/state?country_code=MX

When to use: Populate a state dropdown after country selection.

Full reference →

Get address structure

Returns the required address fields and validation rules for a country.

GET https://queries-test.envia.com/address-structure/{country}

When to use: Dynamically build address forms that adapt to each country's requirements.

Full reference →

Webhooks

Use these to configure real-time notifications instead of polling.

List webhook types

Returns all available webhook event types.

GET https://queries-test.envia.com/webhook-types

When to use: Discover which events you can subscribe to (tracking updates, label created, etc.).

Full reference →

Create webhook

Registers a URL to receive event notifications.

POST https://queries-test.envia.com/webhooks

When to use: Set up real-time tracking updates, shipment notifications, or status change alerts.

Full reference →

Shipment lookups

Use these for dashboards, support tools, and reconciliation.

Get shipments

Returns a paginated list of your shipments.

GET https://queries-test.envia.com/shipment

When to use: Build a shipment history dashboard or export data for reconciliation.

Full reference →

Get single shipment

Returns detailed information for a specific shipment.

GET https://queries-test.envia.com/shipment/{id}

When to use: Customer support lookups or order detail pages.

Full reference →

What about the other 70+ endpoints?

The full Queries API also covers:

• Branches & drop-off points — find carrier service points
• Packages — manage saved package profiles
• Orders — retrieve e-commerce order data
• Notifications — configure email/SMS alerts
• User & company management — account settings and permissions
• Payment & invoices — billing and transaction data

Explore the complete Queries API Reference when you need these capabilities.

What to read next

• See the full flow – The Integration Guide shows how these endpoints fit into a complete shipping integration.
• Start shipping – The Core Workflow guide covers the Shipping API calls that come after carrier discovery.
• Set up webhooks – The Webhooks Guide explains how to register and manage webhooks using the Queries API.