Emerge Carrier API (2.0.0)
https://staging-api.emergemarket.dev.The demo sandbox at
https://demo-api.emergemarket.dev stays available until October 31, 2026.
The Emerge carrier API provides integrated carrier (Provider) developers with access to the Emerge platform.
The current version of the API is v1.0.0 This API will evolve as the features in Emerge's product evolve.
Welcome to Emerge's REST API Carrier Documentation. Our APIs allow Capacity and Integration Providers to easily interact with Shippers utilizing Emerge's Platform.
If you are interested in implementing a Carrier API integration please submit a request here
All production level API requests are made to: https://api.emergemarket.io
The testing sandbox is available during development and for testing: https://staging-api.emergemarket.dev
The sandbox is available during business hours; availability outside those hours is not guaranteed.
Emerge APIs are versioned using a prefix in the endpoint URL. Within an API version, we only make backward-compatible changes. This mean that when a provider integrates with our REST API, the API will continue to work until the version is deprecated. If we have to create a change that is not compatible with the current version, a new version will be created.
Our Carrier APIs enable Capacity Providers more flexibility when working with Shippers using Emerge's Platform. More workflows will become available in the future as we continue growing our Carrier API suite.
While integrating with Emerge, it is helpful to be aware of our nomenclature. Our Shippers create "Opportunities," defined as shipments they are accepting quotes for. When we request a rate, you respond with a "Quote" which is composed of the rate and duration details. Once a Quote is received from our Capacity Providers, it becomes an "Option" for our Shippers to review. You will see these terms throughout our documentation.
In this workflow, Emerge automatically sends Rate Requests to our Capacity Providers on behalf of our Shippers. This workflow makes it easy for Capacity Providers to rate Opportunities while maintaining existing processes. The steps of this workflow include:
Receive a Rate Request Event via Webhook.
a. Rate Requests contain Shipper identifying information in the relationship_identifiers object. These values are provided by the Capacity Provider during Capacity Link onboarding to enable matching in the Provider's application.Review Opportunity details and determine whether to provide a quote.
Send the Rate or provide the Error Reason for declining to rate via the Quote Response Endpoint.
a. A Quote Response must provide the event_id sourced from the Rate Request Event.
b. Providers can respond with either a Rate or an Error to let the shipper know why they are not providing a rate.
c. Providers responding with a rate can include their Quote ID in the provider_reference field.The Rate will be available for Review by the Shipper.