{"templateId":"api_docs","versions":[{"version":5.6,"label":5.6,"link":"/api/5.6/otm","default":false,"active":false,"folderId":"702acf7c"},{"version":5.7,"label":5.7,"link":"/api/5.7/otm","default":false,"active":false,"folderId":"702acf7c"},{"version":5.8,"label":5.8,"link":"/api/5.8/otm","default":true,"active":false,"folderId":"702acf7c"},{"version":"next","label":"next","link":"/api/next/otm","default":false,"active":false,"folderId":"702acf7c"}],"sharedDataIds":{"apiDocsStore":"api-docs-api/@5.8/otm.yaml","sidebar":"sidebar-sidebars.yaml"},"props":{"definitionId":"api/@5.8/otm.yaml","settings":{"baseUrlPath":"/api/5.8/otm"},"disableAutoScroll":true,"seo":{"title":"Open Trip Model","llmstxt":{"hide":true}},"dynamicMarkdocComponents":[],"metadata":{"type":"openapi","title":"Open Trip Model","version":"v5.8.0","description":"## Why OTM?\n\nIn this day and age more and more information about logistics and traffic is shared over the Internet between\nvarious parties. To make this communication easier the _Open Trip Model_ specification was created. It is a\nlightweight data model used to exchange real-time logistic trip data on the web, and to make it easier for\nshippers, carriers, software vendors, OEMs, and truck manufacturers to create new multi-brand applications and\nservices.\n\nTo learn more about the what, the why and the how see the **[OTM documentation website](https://opentripmodel.org/)**.\n## Changelog\n\nFound any bugs on this page? Or have any feature requests for OTM? Create a new ticket on the\n[OTM5 change requests Github page](https://github.com/opentripmodel/otm5-change-requests)\n\n**Unreleased changes**\n\n**Version 5.8 (released on 2026-03-13)**\n* Remove several duplicate definitions of the same entity or fields e.g. unit of measure\n* Add actions property for vehicle entity. This allows to relate actions to a vehicle without the  need to relate them to a trip. E.g. to indicate that a vehicle has a trailer (i.e. transport equipment) attached. [See 108](https://github.com/opentripmodel/otm5-change-requests/issues/108)\n* Better explain the difference between fields `actors[].entity.role` and `actors[].roles` [See 109](https://github.com/opentripmodel/otm5-change-requests/issues/109)\n* Fix inconsistencies in the specification of use of actor entity. [See 110](https://github.com/opentripmodel/otm5-change-requests/issues/110)\n* Add volume property to transport equipment and goods items. This can be provided by means of value and unit (e.g. 120 m3). [See 111](https://github.com/opentripmodel/otm5-change-requests/issues/111)\n* Add support for multiple vehicle fuel types. This deprecated the fields: 'fuel', 'otherFuelType' and 'averageFuelConsumption' on the vehicle entity, and replaces it with a new field 'fuels' that allows for multiple fuel types, each with their own average fuel consumption. [See 112](https://github.com/opentripmodel/otm5-change-requests/issues/112)\n* Extend list of possible fuel types [See 113](https://github.com/opentripmodel/otm5-change-requests/issues/113)\n* Add the possibility to reference entities in the action result and specificy sub results. For example the unload action can be succeeded for certain goods and failed for others, in which case the overall result would be partially succeeded and the sub results would indicate which goods were unloaded successfully and which were not. [See 115](https://github.com/opentripmodel/otm5-change-requests/issues/115)\n* Extend list of possible emission standards with value Z [See 117](https://github.com/opentripmodel/otm5-change-requests/issues/117)\n* Fix missing entityType property for goods sub types items and transport equipment. [See 118](https://github.com/opentripmodel/otm5-change-requests/issues/118)\n* Fix circular polymorphic pattern for actor, person and company. [See 119](https://github.com/opentripmodel/otm5-change-requests/issues/119)\n* Add missing actions property in consignment entity. [See 121](https://github.com/opentripmodel/otm5-change-requests/issues/121)\n\n**Version 5.7 (released on 2025-05-23)**\n\n* Fix broken link to goods packaging type codes. [See 87](https://github.com/opentripmodel/otm5-change-requests/issues/87).\n* Fix inconsistent use of plural name 'geoReferences' for non array property in route definitions. Add new property 'geoReference' and deprecate 'geoReferences'. First one is now required. [See 86](https://github.com/opentripmodel/otm5-change-requests/issues/86).\n* Add enums for location types 'fuelStation', 'serviceStation' and 'other'. Add new property 'otherLocationType' to specify the location type in case of 'other'. [See 73](https://github.com/opentripmodel/otm5-change-requests/issues/73).\n* Add eight new action result reasons, including 'deliveredElsewhere', 'deliveredToWrongReceiver' and 'other'. In case of 'other' the result reason can be provided as free text in the existing remark property. [See 89](https://github.com/opentripmodel/otm5-change-requests/issues/89).\n* Add distance property in move action. This can be provided by means of value and unit (e.g. 120 km) [See 90](https://github.com/opentripmodel/otm5-change-requests/issues/90)\n* Add two specializations of actor, i.e. 'peron' and 'company'. Each with an additional set of properties. [See 100](https://github.com/opentripmodel/otm5-change-requests/issues/100)\n\n**Version 5.6 (released on 2023-11-17)**\n\n* Add loading and unloading consignment in and from transport equipment. [See 63](https://github.com/opentripmodel/otm5-change-requests/issues/63).\n* Add enforceability of a constraint. [See 75](https://github.com/opentripmodel/otm5-change-requests/issues/75).\n* Add recurring date times & durations on actions & events. [See 75](https://github.com/opentripmodel/otm5-change-requests/issues/75).\n* Add sub-locations as optional field on a location. [See 77](https://github.com/opentripmodel/otm5-change-requests/issues/77).\n* Add `owner` as a new type of actor role. [See 78](https://github.com/opentripmodel/otm5-change-requests/issues/78).\n* Add `routeEntityConstraint` and deprecate `routeConstraint`. [See 80](https://github.com/opentripmodel/otm5-change-requests/issues/80).\n\n**Version 5.5 (released on 2023-02-07)**\n\n* Explain when to use `Consignment` vs `Goods` constraints. [See 42](https://github.com/opentripmodel/otm5-change-requests/issues/42).\n* Make `fuel` on vehicle an enum instead of a free string. [See 51](https://github.com/opentripmodel/otm5-change-requests/issues/51).\n* Add `emissionStandardConstraint` as a possible constraint. [See 52](https://github.com/opentripmodel/otm5-change-requests/issues/52).\n* Add `transportOrder` as a field on `Consignment` to enable the two-way relationship. [See 59](https://github.com/opentripmodel/otm5-change-requests/issues/59).\n* Add `eori` as a possible contact detail option. [See 60](https://github.com/opentripmodel/otm5-change-requests/issues/60).\n* Add `valueBoundConstraint` as a possible constraint. [See 61](https://github.com/opentripmodel/otm5-change-requests/issues/61).\n* Add `refuel` as a possible action. [See 62](https://github.com/opentripmodel/otm5-change-requests/issues/62).\n* Add `accessConstraint` as possible constraint. [See 69](https://github.com/opentripmodel/otm5-change-requests/issues/69).\n\n**Version 5.4 (released on 2022-05-09)**\n\n* _Add a `TransportEquipmentConstraint`. [See 46](https://github.com/opentripmodel/otm5-change-requests/issues/46).\n* _Add `averageFuelConsumption` to vehicle. [See 48](https://github.com/opentripmodel/otm5-change-requests/issues/48).\n* _Add fuel consumption and emission events. [See 49](https://github.com/opentripmodel/otm5-change-requests/issues/49).\n* _Add `contextEvents` on entities. [See 49](https://github.com/opentripmodel/otm5-change-requests/issues/49).\n* _Add `sequenceNr` to all action types. [See 50](https://github.com/opentripmodel/otm5-change-requests/issues/50).\n* _Add `cancelled` on action results and `receiverAbsent` as 'reason' type. [See 53](https://github.com/opentripmodel/otm5-change-requests/issues/53).\n* _Add `actors` to all event types. [See 55](https://github.com/opentripmodel/otm5-change-requests/issues/55).\n* _Add `description` to all constraint types. [See 56](https://github.com/opentripmodel/otm5-change-requests/issues/56).\n\n**Version 5.3 (released on 2021-12-16)**\n\n* Support 204 (No Content) for delete requests. [See 23](https://github.com/opentripmodel/otm5-change-requests/issues/23).\n* Add classification lines to goods. [See 26](https://github.com/opentripmodel/otm5-change-requests/issues/26).\n* Add a result to actions. [See 30](https://github.com/opentripmodel/otm5-change-requests/issues/30).\n* Extend ADR with points and transport category. [See 31](https://github.com/opentripmodel/otm5-change-requests/issues/31).\n* Support `relatedConsignments` in consignments. [See 32](https://github.com/opentripmodel/otm5-change-requests/issues/32).\n* Support UNCode and GLN in locations. [See 36](https://github.com/opentripmodel/otm5-change-requests/issues/36).\n* Support `temperatureConstraint` as a possible constraint type. [See 37](https://github.com/opentripmodel/otm5-change-requests/issues/37).\n* Add some references to existing code lists. [See 27](https://github.com/opentripmodel/otm5-change-requests/issues/27).\n    - Using ISO country codes in the country field in addresses.\n    - Using ISO currency codes in 'value-with-unit' fields.\n    - Using the metric system as recommend and default system for dealing with mass, velocity, weight and sizes.\n    - Using the package material codes from the GS1 standard.\n\n**Version 5.2 (released on 2021-09-09)**\n\n* _Add `transportEquipmentSubType` for example to indicate what type of pallets you use. [See 19](https://github.com/opentripmodel/otm5-change-requests/issues/19).\n* _Add `timeWindowConstraint` to replace `startDateTimeConstraint` and `endDateTimeConstraint`. [See 6](https://github.com/opentripmodel/otm5-change-requests/issues/6).\n* _Add `operationalBase` as a location type. [See 22](https://github.com/opentripmodel/otm5-change-requests/issues/22).\n* _Add more actor role types. [See 20](https://github.com/opentripmodel/otm5-change-requests/issues/20).\n* _Add new break and wait actions. [See 17](https://github.com/opentripmodel/otm5-change-requests/issues/17).\n* _Allow for server side UUID generation. [See 16](https://github.com/opentripmodel/otm5-change-requests/issues/16).\n\n**Version 5.1 (released on 2021-06-01)**\n\n* Add an optional `emission` to Vehicle. [See 13](https://github.com/opentripmodel/otm5-change-requests/issues/13).\n* Add an optional `transportMode` to Trip and Move. [See 12](https://github.com/opentripmodel/otm5-change-requests/issues/12).\n* Add optional `grossWeight` to Goods. [See 11](https://github.com/opentripmodel/otm5-change-requests/issues/11).\n* Add`mobilePhone` as contact detail option. [See 5](https://github.com/opentripmodel/otm5-change-requests/issues/5).\n* Add an optional `lastModified` field to each entity. [See 2](https://github.com/opentripmodel/otm5-change-requests/issues/2).\n* Add an optional language to contact details. [See 9](https://github.com/opentripmodel/otm5-change-requests/issues/9).\n* Add a new entity Document to deal with information about files that can be shared. [See 7](https://github.com/opentripmodel/otm5-change-requests/issues/7).\n* Add new statuses to Trip and Consignment. [See 4](https://github.com/opentripmodel/otm5-change-requests/issues/4).\n* Add an optional sensors association to vehicle. [See 2](https://github.com/opentripmodel/otm5-change-requests/issues/2).\n\n**Version 5.0 (only documentation changes)**\n\n* Add documentation about validation endpoints.\n* Add reference to the otm5-change-requests github.\n* Fix the broken checkbox for actions when choosing the `Stop` action.\n* Document the license plate on a `TransportEquipment` (i.e. a trailer).\n"},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"otm-api-spec.redocly.app","port":4000,"ipAddress":"216.73.217.35"},"lang":"default_locale","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"main"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/api/5.8/otm","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}