Introduction

Welcome to the Envoy AI API

Envoy AI automates freight brokerage operations. The API gives you programmatic access to carrier outreach, load management, and offer negotiation -replacing manual phone calls and emails with intelligent automation.

With the API you can ingest loads from your TMS, automatically match them to qualified carriers, track AI-driven outreach, and manage rate offers through their full lifecycle.

Base URL

All API requests are made to:

https://tryenvoy.ai/api/v1

Core resources

The API is organized around six core resources:

Resource	Description
Loads	Freight shipments with origin, destination, equipment type, and rate details.
Carriers	Motor carriers identified by MC and DOT numbers. Verified for safety and fraud.
Outreaches	Records of automated carrier outreach (calls, emails) tied to specific loads.
Offers	Rate offers on loads. Track status through pending, accepted, or rejected.
API Keys	Programmatic credentials scoped to your organization.
Organizations	Organization-level settings and configuration.

Authentication

The API supports two authentication methods:

Bearer Token -Short-lived JWT for dashboard users and interactive sessions. Pass via Authorization: Bearer <token>.
API Key -Long-lived credential for server-to-server integrations and TMS connections. Pass via X-API-Key: <key>.

See Authentication for details on both methods.

How it works

Ingest loads from your TMS via the Loads API or batch endpoint.
Match carriers automatically based on lane preferences, location, and equipment type.
Automate outreach as Envoy AI contacts matched carriers on your behalf.
Manage offers through their lifecycle from creation to acceptance.

Next steps

Authentication

Set up Bearer tokens or API keys to authenticate your requests.

Quickstart

Create your first load and find carrier matches in under 5 minutes.

API Reference

Full reference for every endpoint, schema, and parameter.