How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

C.H. Robinson Events API

C.H. Robinson's Events product gives complete, near real-time order and shipment information, including all transportation updates.Integrating with C.H. Robinson's Events API give partners near visibility into their supply chain directly to their own TMS or ERP system.There are two ways to integrate with C.H. Robinson events: via a callback/webhook (preferred and most real-time) or via a periodic event retrieval (easiest to implement and less real-time).

C.H. Robinson Events API is one of 9 APIs that C.H. Robinson publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Event. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 2 operations across 2 paths, and defines 118 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against 2 base URLs: https://sandbox-api.navisphere.com, https://api.navisphere.com.

2 operations 2 paths 118 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://api.navisphere.com
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

C.H. Robinson Events API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (jwt) (sandbox). It accepts HTTP bearer tokens (jwt) (bearerAuth). By default, every request must be authenticated.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Events 2

C.H. Robinson's Events product gives complete, near real-time order and shipment information, including all transportation updates. Integrating with C.H. Robinson's Events API giv…

POST
/REPLACE_ME_WITH_YOUR_CALLBACK_URL
Events callback
EventsCallback body → 2XX
GET
/v2/events
Event retrieval
EventRetrieval 10 params → 200400401403404500

Schemas 118

The contract defines 118 schemas that model the data the API accepts and returns. The most detailed are orderEventItem (27 properties), globalForwardingShipmentEvent (23 properties), ordersEventsHazardousProperties (22 properties), eventItem (21 properties). Each schema is shown below with its type and property counts.

bookedCustomer
object
The customer(s) on the shipment.
5 properties
globalForwardingStopTypeEnum
string
Indicates the type of the stop.
countryCodeEnum
string
Indicate the country of the location. For a detailed description of all enumerated codes please find them here .
globalForwardingUnknownShipmentStatusValue
string
This represents a new shipment status that has been implemented, but it not yet ready for public consumption.
globalForwardingToAirport
bookedItem
orderEventServiceLevel
string
Identifies the level of service.
globalForwardingServiceLevelEnum
string
globalForwardingAddress
objectnull
6 properties
packageInTransitEvent
object
7 properties
globalForwardingNzCustoms
object
This represents the customs entries for New Zealand.
1 property
ordersEventsHazardousProperties
object
Object containing hazardous material information.
22 properties 1 required
orderEventMode
string
Identifies the mode of the service.
globalForwardingUnknownIncoTermsValue
string
This represents a new INCO terms value that has been implemented, but it not yet ready for public consumption.
globalForwardingAuCustoms
object
This represents the customs entries for Australia.
1 property
globalForwardingFromAirport
globalForwardingModeEnum
string
vesselStowageCategoryEnum
string
Indicates the HazMat Stowage category code according stowage requirements listed in the IMDG Code Dangerous Goods List. A - Stowage category code A B - Stowage…
contactPositionEnum
string
Indicates the type of contact. For a detailed description of all enumerated codes please find them here .
globalForwardingUnknownNzCustomsStatusValue
string
This represents a new New Zealand customs status that has been implemented, but it not yet ready for public consumption.
globalForwardingUnknownContainerTypeValue
string
This represents a new container type that has been implemented, but it not yet ready for public consumption.
eventResponse
object
Contains the response JSON from GET call.
6 properties
globalForwardingPgaStatusEnum
string
globalForwardingUnknownCustomsEntryStatusValue
string
This represents a new customs entry status that has been implemented, but it not yet ready for public consumption.
orderEventService
object
8 properties
globalForwardingShipmentTypeEnum
string
globalForwardingUnknownModeValue
string
This represents a new mode that has been implemented, but it not yet ready for public consumption.
eventAddress
object
Contains address information
8 properties 2 required
hazardousGroupEnum
string
Dangerous goods are assigned into 3 packing groups (also known as UN Packing Group) in accordance with the degree of danger they present. I - Group I - Major D…
globalForwardingQuantity
object
2 properties
orderEventLocation
object
Location information specific to the service.
7 properties
volumeUomEnum
string
Unit of measure for volume parameters.
inTransitAddress
object
Contains address information
5 properties
rateCodeEnum
string
C.H. Robinson defined code for rating code. Here is a list of the most commonly used rate codes: 400 - Line Haul, 405 - Fuel Surchage, 260 - Deliver Surchage,…
error401
object
4 properties 3 required
appointmentEvent
object
7 properties
contactMethod
object
Object defining contact method.
2 properties 2 required
globalForwardingShipmentEvent
object
Represents a Global Forwarding shipment event.
23 properties
eventItem
object
21 properties
proposedCarrier
object
Carrier CHR is proposing to use for this shipment (Only available for Small Parcel Mode).
1 property
error404
object
3 properties 3 required
packageCodeEnum
string
C.H. Robinson defined code for packaging type/code. Here is a list of the most commonly used packagingCodes: BAL - Bale, BAG - Bags, BIN - Bin, BOX - Boxes, CT…
eventPackage
object
Package object.
5 properties
referenceNumber
object
2 properties 2 required
globalForwardingUnknownServiceLevelValue
string
This represents a new service level that has been implemented, but it not yet ready for public consumption.
stopEventLocation
object
Location information specific to the event.
13 properties
globalForwardingAuCustomsN10
object
This represents the N10 document for Australia customs entry.
3 properties
inTransitEvent
object
11 properties
loadDetails
object
Contains load specific information and reference numbers.
2 properties
globalForwardingUnknownAuCustomsStatusValue
string
This represents a new Australia customs status that has been implemented, but it not yet ready for public consumption.
globalForwardingEventTypeEnum
string
The "type" of event for the shipment. If you specify this value in your API request for events, CHR will perform server-side filtering and you will only receiv…
globalForwardingCustoms
object
This represents customs entries.
2 properties
bookedLocation
globalForwardingNzCustomsN10
object
This represents the N10 document for a New Zealand customs entry.
3 properties
error403
object
3 properties 3 required
eventLocation
object
Location information specific to the event.
12 properties
contact
object
Object containing contact information.
4 properties 4 required
globalForwardingUnknownUnitOfMeasureValue
string
This represents a new unit of measure that has been implemented, but it not yet ready for public consumption.
stateProvinceCodeEnum
string
Indicate the state or province of the location. For a detailed description of all enumerated codes please find them here .
error400
object
4 properties
globalForwardingUnknownStopTypeValue
string
This represents a new stop type that has been implemented, but it not yet ready for public consumption.
loadEventOrderDetail
object
Contains order number and order tracking information.
8 properties
freightClassEnum
string
Indicates the freight class on this shipment. (Freight Class is a voluntary standard that provides a comparison of commodities moving in interstate, intrastate…
globalForwardingFreightTermsEnum
stringnull
Prepaid: The shipper pays for the freight charges. Collect: The customer/consignee pays for the freight charges.
globalForwardingUnknownPgaStatusValue
string
This represents a new PGA status value that has been implemented, but it not yet ready for public consumption.
bookedBillTo
object
The bill to(s) on the shipment.
9 properties
condition
string
Identifies the condition.
orderDetail
object
Contains order number and order tracking information.
7 properties
globalForwardingUnknownFreightTermsValue
string
This represents a new freight terms value that has been implemented, but it not yet ready for public consumption.
packageStopEvent
object
6 properties
globalForwardingContainer
object
21 properties
orderEventItem
object
Items tied to the service.
27 properties
eventCharge
object
Object relating to the charges for the order.
5 properties 2 required
eventResponses
object
2 properties
orderEventLocationType
string
Identifies the type of stop the location is.
linearUomEnum
string
Unit of measure for height, width, and length parameters.
globalForwardingOceanMainlineCarrier
objectnull
The mainline carrier that transports the shipment over the ocean.
6 properties
eventLoadPackage
object
Package object.
3 properties
globalForwardingAuCustomsStatusEnum
string
This represents a Australia customs statuses that have been implemented and available for use.
globalForwardingFlight
objectnull
A flight that is used to transport the shipment.
4 properties
globalForwardingUsCustomsEntry
object
The US customs entry for the shipment.
1 property
stopEvent
object
12 properties
currencyCodeEnum
string
Code to indicate the currency being used. The most common currently in use with C.H. Robinson: USD - US Dollar CAD - Canadian Dollar MXN - Mexican Peso EUR - E…
orderNumber
object
1 property
globalForwardingUnknownShipmentTypeValue
string
This represents a new shipment type that has been implemented, but it not yet ready for public consumption.
contactTypeEnum
string
Indicates the type of contact specified: Vendor - Vendor party (Non Transportation Supplier) Buyer - Buyer Party Contact - Contact Party OrderedBy - Ordered By…
contactMethodEnum
string
Indicates the best method for reaching the specified contact.
globalForwardingLocation
object
4 properties
loadStopInformation
object
Stop information specific to the load.
4 properties
orderEventLocationStyle
string
identifies the style of the stop.
globalForwardingNzCustomsStatusEnum
string
This represents a New Zealand customs statuses that have been implemented and available for use.
globalForwardingStop
globalForwardingCustomsEntry
object
The customs entry for the shipment.
4 properties
lateCodeEnum
string
C.H. Robinson defined code for a carrier being late to a stop or reason to schedule new appiontment. Here is a list of the most commonly used late reason codes…
globalForwardingUnknownEventTypeValue
string
This represents a new event type that has been implemented, but it not yet ready for public consumption.
globalForwardingUnknownChrServiceValue
string
This represents a new service level that has been implemented, but it not yet ready for public consumption.
weightUomEnum
string
Unit of measure for weight parameters.
globalForwardingCustomsEntryStatusEnum
string
hazmatCodeEnum
string
Defines the authorizing entity: C - HazMat Canadian Regulatory Authority Codes D - HazMat US Regulatory Authority Codes I - HazMat MX/International Regulatory…
globalForwardingContainerTypeEnum
stringnull
globalForwardingChrServiceEnum
string
globalForwardingShipmentStatusEnum
string
trackingNumberEvent
object
5 properties
invoiceMethodEnum
string
Method which customer will be invoiced. PP - Pre-Paid CL - Collect TP - Third Party PC - Pre-Paid and Add CC - Credit Card
orderEventOrderDetail
object
Contains order number and order tracking information.
5 properties
orderEvent
object
5 properties
globalForwardingUnitOfMeasureEnum
stringnull
loadEvent
object
17 properties
packageInTransitAddress
object
Contains address information
6 properties
globalForwardingPgaStatus
object
The status of the Partner Government Agency (PGA) release for the cargo.
4 properties
inTransitNextStop
object
Contains stop information
5 properties
globalForwardingOceanShipment
objectnull
When this shipment is an ocean shipment, this object will contain ocean shipment details.
8 properties
carrier
object
Object containing carrier information.
14 properties
globalForwardingIncoTermsEnum
stringnull
globalForwardingAirMainlineCarrier
objectnull
The mainline carrier that transports the shipment over air.
4 properties
contactPosition
object
Object containing contact information.
4 properties 4 required
globalForwardingAirShipment
objectnull
When this shipment is an air shipment, this object will contain air shipment details.
19 properties
marinePollutantCategory
string
Indicates the Marine Pollutant Category for Hazardous Materials. Severe Marine Pollutant Marine Pollutant

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ch-robinson-worldwide-events-api-openapi.yml Raw ↑

Other APIs C.H. Robinson publishes across the network.

C.H. Robinson Authentication API
C.H. Robinson Documents API
C.H. Robinson Financials API
C.H. Robinson Labels API
C.H. Robinson Orders and Booking API
C.H. Robinson Rating API
C.H. Robinson Shipments API
C.H. Robinson Visibility API
Where this information came from

This is an independent, third-party profile of C.H. Robinson Events API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.