Electronic pre-load restriction checks
The ePLR API evaluates whether a product may be loaded after the supplied previous loads and cleaning information.
Recommended flow
- Query the scope operation for the target product.
- Collect the required number of previous loads when the scope specifies one.
- Submit the product reference, cleaning state, completed cleaning-procedure codes, optional customer reference, up to five previous products, and an optional tracking number to the check operation.
- Evaluate the overall status and the detailed pre-product restriction and cleaning results.
isClean may be omitted when the cleaning state is unknown. Previous products can be identified by name plus CAS and/or EC numbers. Preserve trackingNumber because Loady returns it unchanged.
If the request says the tank is not clean—or omits a positive clean state—do not send completed cleaning procedures.
The standalone ePLR API derives the shipper company from x-company-id; the carrier API requires the shipper
companyId in its request.
The response includes the evaluated product, policy, timestamp, optional tracking number, overall result, the result without cleaning, cleaning-state result, cleaning-procedure result, and detailed restriction results where applicable. Do not treat the result that ignores cleaning as final.