The ONE Record API vocabulary, described using W3C RDF Schema and the Web Ontology Language.
ONE Record API Ontology
The ontology of the ONE Record API is the data model underlying for standard ONE Record API: https://github.com/IATA-Cargo/ONE-Record. ONE Record is a standard for data sharing and creates a single record view of the shipment. This standard defines a common data model for the data that is shared via standardized and secured web API.
For a detailed Changelog, see https://iata-cargo.github.io/ONE-Record/2026-07/General/release-note/
has Access Delegation
Contains submitted Change object
has Change
Recorded change requests in the Audit Trail of a Logistics Object
has Change Request
Links to the list of Creation Results
has Creation Results
The data holder of the servers data.
has Data Holder
Error object(s) if the processing was not successful
has Error
Error details
has Error Detail
has Event Type
Item that is contained in a collection
has Item
has Logistics Object
Operation(s) to apply as PATCH on a Logistics Object
has Operation
has Permission
Historical request status entries of an Action Request.
has Request Status History
Contains the severity of the Error
has Severity
has Subscriber
Link to the requestors Subscription object with all subscription information
has Subscription
has Topic Type
An array used to indicate the specific types of notifications that the subscriber desires to receive from the publisher. The subscriber is required to specify their preferences on a per-type basis
Include Subscription Event Type
Organization that changed the request status.
is Changed By
Organization Identifier that represents the Organization that has requested the action
is Requested By
is Requested For
is Revoked By
Optional URI to the ChangeRequest that triggered a Notification if the eventType is one of CHANGE_REQUEST_ACCEPTED, CHANGE_REQUEST_REJECT, or CHANGE_REQUEST_FAILED
is Triggered By
Expiry date as date time of the subscription information that supports caching but does not require the ONE Record client to store the datetime when the Subscription object was received; if not given: the information does not expire
Expires at
List of all changed properties as IRIs after a ChangeRequest was successfully applied, e.g. [https://onerecord.iata.org/ns/cargo#hasVolumetricWeight, https://onerecord.iata.org/ns/cargo/#hasGoodsDescription]
Changed property
Error code is a numeric or alphanumeric code that can be used to determine the source of the error and why it occured.
Code
Content types that the subscriber wants to receive in the notifications, e.g. application/ld+json
Content type
Data type of the field to update, must be a valid URI, e.g. http://www.w3.org/2001/XMLSchema#int
Datatype
Reason for the request (optional)
Description
Contains the HTTP status of the request
HTTP Status
Latest revision of the Logistics Object. Starting with revision 0
Latest revision
The type of cargo:LogisticsObject in the notification e.g. https://onerecord.iata.org/ns/cargo#Piece
has Logistics Object Type
Message that describes the error
Message
Property of the object for which the error applies in IRI format, i.e. https://onerecord.iata.org/ns/cargo#hasVolumetricWeight
Property
Date and time from which the request status applies.
has Request Status Since
URI of the object where the error occurred
Resource
Revision number of the Logistics Object, starting with 0 for changing the initial revision of a Logistics Object
Revision
ONE Record API endpoint
Server endpoint
Supported ONE Record API versions by the server, MUST include at least one supported version.
Supported API version
Supported content types of the server, MUST contain at least application/ld+json
Supported content type
Optional list of supported encodings of the ONE Record server, e.g. gzip
Supported encoding
Supported languages of the ONE Record API, minimum is en-US (American English)
Supported language
Supported ontologies on the server, MUST be non-versioned IRIs
Supported ontology
Supported ontology versions on the server, MUST be versioned IRIs
Supported ontology version
Short summary of the error
Title
The Logistics Object type or specific Logistics Object to which the subscription belongs to e.g. https://onerecord.iata.org/Piece or https://1r.example.com/7f01363f-0c6a-4414-be48-d3692e219b91
Topic
The number of total items created
Total Created
The total number of failed creations
Total Failed
The number of total items contained in a collection
Total items
Updated value for the field
Value
Datetime when the request was created
Requested at
The datetime when the action request was revoked.
Revoked at
Flag specifying if the requestor wants to receive Notification from the publisher when the status of an action request changed, default=FALSE
notify RequestStatus Change
Operations objects must have exactly one p, predicate, member. The value of this member must be an URI, e.g. https://onerecord.iata.org/ns/cargo#hasGoodsDescription
Operation objects MUST have exactly one "s", subject, member. The value of this member MUST be one of IRI or blank node.
Flag specifying if the publisher should send the whole logistics object or not in the notification object
Send LogisticsObject body
Indicates the orchestration version used to map the information with messaging standards
Uses Orchestration
Access to a Logistics Object delegated to an Organization
Access Delegation
Delegation Request to 3rd parties
Access Delegation Request
Superclass for all kinds of requests (i.e someone requsted something (e.g. subscription, access, etc.) at a publisher/holder of a logistics object)
Action Request
Audit trail of a Logistics Object
Audit Trail
Change
Change Request containing updates on a Logistics Object
Change Request
Used as response of endpoints returning a collection of more than one graph, i.e. more than one not linked subjects.
Collection
Error model
Error
Error details that belong to an error
Error Detail
Contains the outcome of logistics event creation requests processed through a multiple-events creation API.
Event Creation Result
Container object that summarizes the results of multiple operations
Multi Status Response
Notification sent by the publisher to the subscriber
Notification
Notification Event Type
Operation Request contained in the PATCH body
Operation
Object to modify in the PATCH request
Operation Object
Patch Operation
Permission
RequestStatus
Entry representing an historical request status and the date and time from which it applied
Request Status Entry
Information about the ONE Record server
Server Information
Severity
Subscription information sent to the publisher
Subscription
Subscription Event Type
SubscriptionRequest initiated by subscribers to publisher (data holder) for themselves or for a third party subscriber.
Subscription Request
Topic Type
Verification encapulates any anomalies or errors related to logistics objects
Verification
Verification Request allows third parties to signal errors and anomalies on logisitcs objects
ACCESS_DELEGATION_REQUEST_ACCEPTED
ACCESS_DELEGATION_REQUEST_FAILED
ACCESS_DELEGATION_REQUEST_PENDING
ACCESS_DELEGATION_REQUEST_REJECTED
ACCESS_DELEGATION_REQUEST_REVOKED
Defines a :PatchOperation to be an operation that adds new triples.
ADD
:EventType for accepted :ChangeRequests
CHANGE_REQUEST_ACCEPTED
CHANGE_REQUEST_FAILED
:EventType for rejected :ChangeRequests.
CHANGE_REQUEST_REVOKED
DELETE
:Permission to get a :LogisticsEvent
GET_LOGISTICS_EVENT
:Permission to get a :LogisticsObject
GET_LOGISTICS_OBJECT
LOGISTICS_EVENT_RECEIVED
LOGISTICS_OBJECT_ACCESS_GRANTED
LOGISTICS_OBJECT_AVAILABLE
LOGISTICS_OBJECT_CREATED
LOGISTICS_OBJECT_IDENTIFIER
LOGISTICS_OBJECT_TYPE
LOGISTICS_OBJECT_UPDATED
PATCH_LOGISTICS_OBJECT
:Permission to add a logistics event.
REQUEST_ACCEPTED
REQUEST_ACKNOWLEDGED
REQUEST_FAILED
REQUEST_PENDING
REQUEST_REJECTED
REQUEST_REVOKED
SUBSCRIPTION_REQUEST_ACCEPTED
SUBSCRIPTION_REQUEST_FAILED
SUBSCRIPTION_REQUEST_PENDING
SUBSCRIPTION_REQUEST_REJECTED
SUBSCRIPTION_REQUEST_REVOKED
VERIFICATION_REQUEST_ACKNOWLEDGED
VERIFICATION_REQUEST_FAILED
VERIFICATION_REQUEST_PENDING
VERIFICATION_REQUEST_REJECTED
VERIFICATION_REQUEST_REVOKED