Collection endpoints for retrieving OMSA resources and query results.
List assets for package or leg
Retrieves asset information for a package, optionally filtered by leg.
query Parameters
packageIdthe identifier of a package
legIdleg identifier
default string, full names etc (length 0-200)
limitThe optional limit parameter limits the number of items that are presented in the response document. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Minimum = 1. Maximum = 10000. Default = 100.
offsetThe optional offset parameter representing the starting index of the returned collection. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Default = 0.
bboxOnly features that have a geometry that intersects the bounding box are selected. The bounding box is provided as four or six numbers, depending on whether the coordinate reference system includes a vertical axis (height or depth): * Lower left corner, coordinate axis 1 * Lower left corner, coordinate axis 2 * Minimum value, coordinate axis 3 (optional) * Upper right corner, coordinate axis 1 * Upper right corner, coordinate axis 2 * Maximum value, coordinate axis 3 (optional)
If the value consists of four numbers, the coordinate reference system is WGS 84 longitude/latitude (http://www.opengis.net/def/crs/OGC/1.3/CRS84)
unless a different coordinate reference system is specified in the parameter bbox-crs.
If the value consists of six numbers, the coordinate reference system is WGS 84 longitude/latitude/ellipsoidal height (http://www.opengis.net/def/crs/OGC/0/CRS84h) unless a different coordinate reference system is specified in the parameter bbox-crs.
The query parameter bbox-crs is specified in OGC API - Features - Part 2: Coordinate Reference Systems by Reference.
For WGS 84 longitude/latitude the values are in most cases the sequence of minimum longitude, minimum latitude, maximum longitude and maximum latitude.
However, in cases where the box spans the antimeridian the first value (west-most box edge) is larger than the third value (east-most box edge).
If the vertical axis is included, the third and the sixth number are the bottom and the top of the 3-dimensional bounding box.
If a feature has multiple spatial geometry properties, it is the decision of the server whether only a single spatial geometry property is used to determine the extent or all relevant geometries.
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List assets for package or leg › Responses
a geojson response
type^(FeatureCollection)…actions that can be performed on this package, but also alternative (rel=alternative+1, alternative+2) offers or references to other resources In case it is an alternative, specify clearly in the description what the financial consequences are.
propertiesnumberMatchednumberReturnedList purchased packages
Returns a paginated list of packages belonging to the authenticated user.
query Parameters
limitThe optional limit parameter limits the number of items that are presented in the response document. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Minimum = 1. Maximum = 10000. Default = 100.
offsetThe optional offset parameter representing the starting index of the returned collection. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Default = 0.
packageIdthe identifier of a package (maps to Orders id)
customerIdoptional owner customer identifier filter (maps to Orders createdBy, exact match only)
default string, full names etc (length 0-200)
contactCustomerIdoptional contact customer identifier filter (maps to Orders contact, exact match only)
default string, full names etc (length 0-200)
balanceoptional package balance filter, passed through to Orders balance filter
createdAtoptional package created-at filter, passed through to Orders createdAt filter
currencyoptional package currency filter, passed through to Orders currency filter
datedServiceJourneyIdoptional package dated service journey ID filter, passed through to Orders datedServiceJourneyId filter
distributionChannelIdoptional package distribution channel ID filter, passed through to Orders distributionChannelId filter
endTimeoptional package end-time filter, passed through to Orders endTime filter
externalReferenceoptional package external reference filter, passed through to Orders externalReference filter
fromStopPlaceIdoptional package from stop place ID filter, passed through to Orders fromStopPlaceId filter
lastConfirmedAtoptional package last-confirmed-at filter, passed through to Orders lastConfirmedAt filter
orderByoptional package orderBy value, passed through to Orders orderBy
legExternalReferenceoptional package leg external reference filter, mapped to Orders orderLineExternalReference
legIdoptional package leg identifier filter, mapped to Orders orderLineId
organisationIdoptional package organisation ID filter, passed through to Orders organisationId filter
originalDatedServiceJourneyIdoptional package original dated service journey ID filter, passed through to Orders originalDatedServiceJourneyId filter
posoptional package POS filter, passed through to Orders pos filter
reservationIdoptional package reservation ID filter, passed through to Orders reservationId filter
productIdoptional package product ID filter, mapped to Orders fareProductId
fareProductVersionoptional package fare product version filter, passed through to Orders fareProductVersion filter
serviceJourneyIdoptional package service journey ID filter, passed through to Orders serviceJourneyId filter
sortByoptional package sort direction (ASC or DESC), passed through to Orders sortBy
startTimeoptional package start-time filter, passed through to Orders startTime filter
toStopPlaceIdoptional package to stop place ID filter, passed through to Orders toStopPlaceId filter
totalAmountoptional package total amount filter, passed through to Orders totalAmount filter
totalTaxAmountoptional package total tax amount filter, passed through to Orders totalTaxAmount filter
versionoptional package version filter, passed through to Orders version filter
statusFilter packages by their lifecycle status (e.g. CONFIRMED, CANCELLED)
The life-cycle state of the package (from NEW to ENDED)
OFFERED the package is offered
SELECTED the package is selected to modify
PENDING the purchase of the package is not confirmed (the end user has shown intentions to purchase this offer), must be finalized with the package-confirm operation
CONFIRMED a finalized package ('purchased'). Both parties agreed to deliver services in return of payment
CANCELLED the package is cancelled after it is purchased. The agreement will specify whether there is a refund, or under which conditions
EXPIRED the MP didn't respond on time, the package offer has been expired
STARTED the package is started, the trip execution module is needed now to manage the execution of the package
ENDED the package has ended, the trip has been executed
RELEASED for internal archiving, the package has not been purchased.
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List purchased packages › Responses
A list of packages
typeActions that can be performed on this collection.
numberMatchedTotal number of packages available (for pagination)
numberReturnedNumber of packages in this response
List customers with filters
Retrieve customers with optional filters and pagination.
query Parameters
limitThe optional limit parameter limits the number of items that are presented in the response document. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Minimum = 1. Maximum = 10000. Default = 100.
offsetThe optional offset parameter representing the starting index of the returned collection. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Default = 0.
customerIdoptional customer identifier filter
default string, full names etc (length 0-200)
firstNameoptional first name filter
short string, display names (length 0-75)
lastNameoptional last name filter
short string, display names (length 0-75)
emailoptional email filter
default string, full names etc (length 0-200)
phoneNumberoptional phone number filter
default string, full names etc (length 0-200)
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List customers with filters › Responses
a customer collection response
typeactions that can be performed on this package, but also alternative (rel=alternative+1, alternative+2) offers or references to other resources In case it is an alternative, specify clearly in the description what the financial consequences are.
numberMatchednumberReturnedCreate customer record
Create a customer record that can be used for purchases.
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
Create customer record › Request Body
lastNameshort string, display names (length 0-75)
firstNameshort string, display names (length 0-75)
emaildefault string, full names etc (length 0-200)
prefixreal short string, codes (length 0-10)
address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language
postfixreal short string, codes (length 0-10)
initialsreal short string, codes (length 0-10)
middleNameshort string, display names (length 0-75)
dateOfBirthhttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, full-date (2019-10-12)
phoneNumberdefault string, full names etc (length 0-200)
placeOfBirthshort string, display names (length 0-75)
countryOfBirth[A-Z]{2}two-letter country codes according to ISO 3166-1
dictionary for extra fields (bilatural agreements)
Create customer record › Responses
a customer response
lastNameshort string, display names (length 0-75)
firstNameshort string, display names (length 0-75)
iddefault string, full names etc (length 0-200)
emaildefault string, full names etc (length 0-200)
prefixreal short string, codes (length 0-10)
address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language
postfixreal short string, codes (length 0-10)
initialsreal short string, codes (length 0-10)
middleNameshort string, display names (length 0-75)
dateOfBirthhttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, full-date (2019-10-12)
phoneNumberdefault string, full names etc (length 0-200)
placeOfBirthshort string, display names (length 0-75)
countryOfBirth[A-Z]{2}two-letter country codes according to ISO 3166-1
dictionary for extra fields (bilatural agreements)
List ancillaries for package or leg
Retrieves ancillary products for a package, optionally filtered by leg.
query Parameters
packageIdthe identifier of a package
legIdleg identifier
default string, full names etc (length 0-200)
limitThe optional limit parameter limits the number of items that are presented in the response document. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Minimum = 1. Maximum = 10000. Default = 100.
offsetThe optional offset parameter representing the starting index of the returned collection. Only items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted. Default = 0.
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List ancillaries for package or leg › Responses
a ancillaries response
type^(AncillaryCollectio… · requiredactions that can be performed on this package, but also alternative (rel=alternative+1, alternative+2) offers or references to other resources In case it is an alternative, specify clearly in the description what the financial consequences are.
numberMatchednumberReturnedList configured external data sources
Retrieves all datasources
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List configured external data sources › Responses
a list of datasources
relthe action that can be performed OR part of the URI allowed values include the 'processId's, prefixes for the referenced data sources, prefixes for deeplinks ('apple' and 'android'), OGC compliant ones (alternative, next, etc)
hrefvalid URL
bodythe (prefilled) body for the request
hashto validate that the content of the link hasn't been changed.
typeshort string, display names (length 0-75)
methodto indicate the http method.
descriptionthe description of the external data source
isMandatoryis this link informative, or must it be used?
List available change options
Retrieves available change options for a package.
query Parameters
packageIdthe identifier of a package
legIdleg identifier
default string, full names etc (length 0-200)
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
Entur-Distribution-ChannelDistribution channel identifier used by downstream sales and ticket distribution services.
Entur-POSPoint-of-sale identifier used by downstream sales and ticket distribution services.
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List available change options › Responses
a response with change options
type^(ChangeOptionCollec… · requiredactions that can be performed on this collection
numberMatchednumberReturnedList available refund options
Retrieves available refund options for a package.
query Parameters
packageIdthe identifier of a package
legIdleg identifier
default string, full names etc (length 0-200)
travellerIdtraveller identifier
default string, full names etc (length 0-200)
ancillaryIdancillary identifier
default string, full names etc (length 0-200)
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
Entur-Distribution-ChannelDistribution channel identifier used by downstream sales and ticket distribution services.
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List available refund options › Responses
a response with refund options
type^(RefundOptionCollec… · requiredactions that can be performed on this package, but also alternative (rel=alternative+1, alternative+2) offers or references to other resources In case it is an alternative, specify clearly in the description what the financial consequences are.
numberMatchednumberReturnedList travel documents for package
Retrieves travel documents for a package with optional status filtering.
query Parameters
packageIdthe identifier of a package
legIdleg identifier
default string, full names etc (length 0-200)
statusFilter travel documents by status
The lifecycle status of a travel document.
PENDING the document is being processed or awaiting distribution pickup
ACTIVE the document is ready for use
FAILED the document distribution failed
EXPIRED the document has expired
CANCELLED the document has been cancelled
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
Entur-Distribution-ChannelDistribution channel identifier used by downstream sales and ticket distribution services.
Entur-POSPoint-of-sale identifier used by downstream sales and ticket distribution services.
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
List travel documents for package › Responses
a response to obtain travel document (references)
type^(TravelDocumentColl… · requiredactions that can be performed on this package, but also alternative (rel=alternative+1, alternative+2) offers or references to other resources In case it is an alternative, specify clearly in the description what the financial consequences are.
numberMatchednumberReturnedGet package by ID
Retrieves a single package by identifier.
path Parameters
packageIdThe unique identifier of the package to retrieve
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
Get package by ID › Responses
a geojson response, containing the package details in the main properties and the legs are represented in the features
type^(package)$ · requiredan amount of money, usable in fares, fare calculations or in extra costs.
statusThe life-cycle state of the package (from NEW to ENDED)
OFFERED the package is offered
SELECTED the package is selected to modify
PENDING the purchase of the package is not confirmed (the end user has shown intentions to purchase this offer), must be finalized with the package-confirm operation
CONFIRMED a finalized package ('purchased'). Both parties agreed to deliver services in return of payment
CANCELLED the package is cancelled after it is purchased. The agreement will specify whether there is a refund, or under which conditions
EXPIRED the MP didn't respond on time, the package offer has been expired
STARTED the package is started, the trip execution module is needed now to manage the execution of the package
ENDED the package has ended, the trip has been executed
RELEASED for internal archiving, the package has not been purchased.
use an ID contained in the placeDefinitions field, or from an external source, when using coordinates, please use the prefix 'gps:'
endTimehttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, date-time (2019-10-12T07:20:50.52Z)
startTimehttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, date-time (2019-10-12T07:20:50.52Z)
Places that are not specified in an external data source (like a home address)
idguaranteesexternalReferencedefault string, full names etc (length 0-200)
Get customer by ID
Retrieves a single customer by identifier.
path Parameters
customerIdcustomer identifier
default string, full names etc (length 0-200)
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
Get customer by ID › Responses
a customer response
lastNameshort string, display names (length 0-75)
firstNameshort string, display names (length 0-75)
iddefault string, full names etc (length 0-200)
emaildefault string, full names etc (length 0-200)
prefixreal short string, codes (length 0-10)
address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language
postfixreal short string, codes (length 0-10)
initialsreal short string, codes (length 0-10)
middleNameshort string, display names (length 0-75)
dateOfBirthhttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, full-date (2019-10-12)
phoneNumberdefault string, full names etc (length 0-200)
placeOfBirthshort string, display names (length 0-75)
countryOfBirth[A-Z]{2}two-letter country codes according to ISO 3166-1
dictionary for extra fields (bilatural agreements)
Replace customer record
Replace the customer record.
path Parameters
customerIdcustomer identifier
default string, full names etc (length 0-200)
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
Replace customer record › Request Body
lastNameshort string, display names (length 0-75)
firstNameshort string, display names (length 0-75)
emaildefault string, full names etc (length 0-200)
prefixreal short string, codes (length 0-10)
address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language
postfixreal short string, codes (length 0-10)
initialsreal short string, codes (length 0-10)
middleNameshort string, display names (length 0-75)
dateOfBirthhttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, full-date (2019-10-12)
phoneNumberdefault string, full names etc (length 0-200)
placeOfBirthshort string, display names (length 0-75)
countryOfBirth[A-Z]{2}two-letter country codes according to ISO 3166-1
dictionary for extra fields (bilatural agreements)
Replace customer record › Responses
a customer response
lastNameshort string, display names (length 0-75)
firstNameshort string, display names (length 0-75)
iddefault string, full names etc (length 0-200)
emaildefault string, full names etc (length 0-200)
prefixreal short string, codes (length 0-10)
address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language
postfixreal short string, codes (length 0-10)
initialsreal short string, codes (length 0-10)
middleNameshort string, display names (length 0-75)
dateOfBirthhttps://www.rfc-editor.org/rfc/rfc3339#section-5.6, full-date (2019-10-12)
phoneNumberdefault string, full names etc (length 0-200)
placeOfBirthshort string, display names (length 0-75)
countryOfBirth[A-Z]{2}two-letter country codes according to ISO 3166-1
dictionary for extra fields (bilatural agreements)
Delete customer record
Delete the customer record.
path Parameters
customerIdcustomer identifier
default string, full names etc (length 0-200)
Headers
Accept-Languageshort string, display names (length 0-75)
authorizationHeader field, JWT must be supplied
ET-Client-NameEntur Client Header.
It is required that all consumers identify themselves by using this header.
Entur will deploy strict rate-limiting policies on API-consumers who do not identify with a header and reserves the right to block unidentified consumers.
The structure of ET-Client-Name should be: <company>-<application> for companies, and <personal name>-<application> for individuals.
X-Correlation-IdCorrelation id
Entur-Client-NameEncouraged for tracing and routing, but not required.
Entur-Log-LevelOptional request-scoped logging level. OMSA forwards the effective value to downstream APIs that support request-level logging.
Delete customer record › Responses
Customer deleted successfully