Use this endpoint to test an equipment identifier to see if it is a valid equipment identifier for the given carrier that may be used for tracking. If the carrier's tracking vendor does not support validating equipment identifiers without initiating tracking, then the endpoint will always report that the identifier is valid.
Equipment ID Type | valid | exists | Notes |
---|---|---|---|
EMERSON_DEVICE_ID , SENSITECH_DEVICE_ID , TIVE_DEVICE_ID , VEHICLE_ID | True, if the equipment exists and is considered as active equipment by project44. This equipment is owned by the capacity provider and sent in the query params. Validity depends on the type of vendor. | True, if the equipment exists in the project44 system This equipment is owned by the capacity provider and passed as an argument to the endpoint (see | The capacity provider identifier passed as an argument to the endpoint must be the owner of the equipment. |
LICENSE_PLATE | True, if the asset can be used for tracking the shipment by the requester. | True, if the license plate exists in the project44 system. | capacity provider identifier should be set to one of identifiers of requesting organisation |
MOBILE_PHONE_NUMBER | True, if there is a driver who signed up with the given phone number OR if there is no driver who signed up with the given phone number but the phone number can be used to create a shipment. (see | True, if the mobile phone was used in the past to create a shipment. False, if there is no driver with such phone number in project44 network. |
OK
Invalid request
Invalid or missing credentials
User not authorized to perform this operation
{- "exists": true,
- "ownershipStatus": "CONNECTED",
- "valid": true
}