API Reference

Common Validation Errors

Common causes of load and carrier validation errors.

Common Errors for Loads

Zip Code

  • Error Message: Zip code for an itinerary doesn’t exist in geoset.
  • Description: The zip code supplied for any of the stops in the itinerary does not exist in the geoset.

Appointment Open Time

  • Error Message: Appointment open time is in the past.
  • Description: The first stop in the itinerary has an open time that occurs in the past; that is, the open_time is less than the current date_time.

Appointment Close Time

  • Error Message: Appointment close time is in the past.
  • Description: The first stop in the itinerary has a close time that occurs in the past; that is, the close_time is less than the current date_time.

Banned Commodity

  • Error Message: Banned Commodity.
  • Description: The commodity is in the list of commodities that we have banned or do not allow; for example, Ghost Load.

Max Expiration Time

  • Error Message: Field validation for 'ExpiredAt' failed on the 'max_expired_at' tag.
  • Description: The expired_at timestamp is greater than the 28 days from the current date_time.

Origin Open Time

  • Error Message: Field validation for 'OriginOpenTime' failed on the 'open_time_lt' tag.
  • Description: The first stop (origin) in the itinerary has an open_time that is greater than:
    • its close_time
    • the last stop’s (destination's) open_time

Destination Open Time

  • Error Message: Field validation for 'DestinationOpenTime' failed on the 'open_time_lt' tag.
  • Description: The last stop (destination) in the itinerary has an open_time greater than its close_time.

Duplicate Load Reference

  • Error Message: Duplicate load reference.
  • Description: This load reference already exists. Load reference is a unique identifier.

Load Weight

  • Error Message: Key: 'Load.Weight' Error:Field validation for 'Weight' failed on the 'gt' tag.
  • Description: The load weight supplied is less than or equal to 0.

Update Not Applied to Load

  • Error Message: After requesting updates for a load, no values have changed.
  • Description: Updates are made using field masks to map the changing data. Field masks specify the subset of fields that should be modified by the update operation. If the field mask is missing a value, no update is applied. You can learn about field masks in detail in our reference article about updating a load.

Trailer Length

  • Error Message: "Key: 'Load.TrailerLength' Error:Field validation for 'TrailerLength' failed on the 'lte' tag".
  • Description: Motive imposes an allowed limit for trailer length. Trailer length must be less than or equal to 2147483647.

Phone

  • Error Message: "Key: 'Load.ExtraAttrs.Contact.Phone' Error:Field validation for 'Phone' failed on the 'phone' tag".
  • Description: Supply a phone number that consists of a country code followed by an area code and a local number. In the U.S., this is a 10-digit number. Supply numbers only, without special characters.

Common Validation Errors for Carriers

Carrier Identifier

If Carrier ID Missing or Incorrect

  • Error Message: Invalid identifier type/value.
  • Description: The identifier type in the request payload is either missing or incorrect. In your call, you must provide either the USDOT or the MC/MX/FF number. Refer to Step 2. Create a freight partner carrier. to learn more.

If Carrier ID Does Not Exist

  • Error Message: "Key: 'FreightPartnerCarrier.Identifier' Error:Field validation for 'Identifier' failed on the 'required' tag".
  • Description: The value supplied as identifier type (MC/MX/FF or USDOT) in the request payload does not exist.

Carrier Status

  • Error Message: "Unknown value "\"STATUS_ALOWED\"" for enum keeptruckin.proto.freight.services.loadboard.Carrier.Status".
  • Description: The carrier status field has a value other than allowed or blocked (the only two accepted values). Refer to Step 2. Create a freight partner carrier. to learn more.

Reserved Carrier

  • Error Message: Reserved carrier cannot be created, deleted or updated.
  • Description: Motive has a reserved carrier whose identifier is DUMSLB1; this identifier cannot be used for any API calls.