Entur Developer
Sales v2

collections

Server

Collection endpoints for retrieving resources and query results.


List assets for package or leg

GET
https://api.entur.io/omsa/v1
/collections/assets/items

Retrieves asset information for a package, optionally filtered by leg.

List assets for package or leg › query Parameters

packageId
​string · required · style: form · explode: true

the identifier of a package

legId
​normalString · maxLength: 200 · required · style: form · explode: true

leg identifier

default string, full names etc (length 0-200)

limit
​integer · min: 1 · max: 10000 · style: form

The 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.

Default: 100
offset
​integer · min: 0 · style: form

The 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.

Default: 0
bbox
​number[] · style: form

Only 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.

List assets for package or leg › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List assets for package or leg › Responses

a geojson response

type
​string · pattern: ^(FeatureCollection)…
​geojsonFeature[]
properties
​object
​object
numberMatched
​integer
numberReturned
​integer
​link[]

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.


List ancillaries for package or leg

GET
https://api.entur.io/omsa/v1
/collections/ancillaries/items

Retrieves ancillary products for a package, optionally filtered by leg.

List ancillaries for package or leg › query Parameters

packageId
​string · required · style: form · explode: true

the identifier of a package

legId
​normalString · maxLength: 200 · required · style: form · explode: true

leg identifier

default string, full names etc (length 0-200)

limit
​integer · min: 1 · max: 10000 · style: form

The 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.

Default: 100
offset
​integer · min: 0 · style: form

The 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.

Default: 0

List ancillaries for package or leg › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List ancillaries for package or leg › Responses

a ancillaries response

type
​string · pattern: ^(AncillaryCollectio… · required
​object[]
numberMatched
​integer
numberReturned
​integer
​link[]

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.


List available change options

GET
https://api.entur.io/omsa/v1
/collections/change-options/items

Retrieves available change options for a package.

List available change options › query Parameters

packageId
​string · required · style: form · explode: true

the identifier of a package

legId
​normalString · maxLength: 200 · style: form · explode: true

leg identifier

default string, full names etc (length 0-200)

List available change options › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

Entur-Distribution-Channel
​string · required · style: simple

Distribution channel identifier used by downstream sales and ticket distribution services.

Entur-POS
​string · required · style: simple

Point-of-sale identifier used by downstream sales and ticket distribution services.

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List available change options › Responses

a response with change options

type
​string · pattern: ^(ChangeOptionCollec… · required
​object[]
numberMatched
​integer
numberReturned
​integer
​link[]

actions that can be performed on this collection


List available refund options

GET
https://api.entur.io/omsa/v1
/collections/refund-options/items

Retrieves available refund options for a package.

List available refund options › query Parameters

packageId
​string · required · style: form · explode: true

the identifier of a package

legId
​normalString · maxLength: 200 · style: form · explode: true

leg identifier

default string, full names etc (length 0-200)

travellerId
​normalString · maxLength: 200 · style: form · explode: true

traveller identifier

default string, full names etc (length 0-200)

ancillaryId
​normalString · maxLength: 200 · style: form · explode: true

ancillary identifier

default string, full names etc (length 0-200)

List available refund options › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

Entur-Distribution-Channel
​string · required · style: simple

Distribution channel identifier used by downstream sales and ticket distribution services.

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List available refund options › Responses

a response with refund options

type
​string · pattern: ^(RefundOptionCollec… · required
​object[]
numberMatched
​integer
numberReturned
​integer
​link[]

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.


List travel documents for package

GET
https://api.entur.io/omsa/v1
/collections/travel-documents/items

Retrieves travel documents for a package with optional status filtering.

List travel documents for package › query Parameters

packageId
​string · required · style: form · explode: true

the identifier of a package

legId
​normalString · maxLength: 200 · style: form · explode: true

leg identifier

default string, full names etc (length 0-200)

status
​travelDocumentStatus · enum · style: form · explode: true

Filter 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

Enum values:
PENDING
ACTIVE
FAILED
EXPIRED
CANCELLED

List travel documents for package › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

Entur-Distribution-Channel
​string · required · style: simple

Distribution channel identifier used by downstream sales and ticket distribution services.

Entur-POS
​string · required · style: simple

Point-of-sale identifier used by downstream sales and ticket distribution services.

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List travel documents for package › Responses

a response to obtain travel document (references)

type
​string · pattern: ^(TravelDocumentColl… · required
​object[]
numberMatched
​integer
numberReturned
​integer
​link[]

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.


List configured external data sources

GET
https://api.entur.io/omsa/v1
/collections/datasources/items

Retrieves all datasources

List configured external data sources › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List configured external data sources › Responses

a list of datasources

rel
​string · required

the 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)

href
​url · uri · required

valid URL

type
​shortString · maxLength: 75

short string, display names (length 0-75)

method
​string · enum

to indicate the http method.

Enum values:
POST
GET
PUT
DELETE
PATCH
description
​string

the description of the external data source

body
​object

the (prefilled) body for the request

​object
isMandatory
​boolean

is this link informative, or must it be used?

hash
​string

to validate that the content of the link hasn't been changed.


List purchased packages

GET
https://api.entur.io/omsa/v1
/collections/packages/items

Returns a paginated list of packages belonging to the authenticated user.

List purchased packages › query Parameters

limit
​integer · min: 1 · max: 10000 · style: form

The 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.

Default: 100
offset
​integer · min: 0 · style: form

The 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.

Default: 0
packageId
​string · style: form · explode: true

the identifier of a package (maps to Orders id)

customerId
​normalString · maxLength: 200 · style: form · explode: true

optional owner customer identifier filter (maps to Orders createdBy, exact match only)

default string, full names etc (length 0-200)

contactCustomerId
​normalString · maxLength: 200 · style: form · explode: true

optional contact customer identifier filter (maps to Orders contact, exact match only)

default string, full names etc (length 0-200)

balance
​string[] · style: form · explode: true

optional package balance filter, passed through to Orders balance filter

createdAt
​string[] · style: form · explode: true

optional package created-at filter, passed through to Orders createdAt filter

currency
​string[] · style: form · explode: true

optional package currency filter, passed through to Orders currency filter

datedServiceJourneyId
​string[] · style: form · explode: true

optional package dated service journey ID filter, passed through to Orders datedServiceJourneyId filter

distributionChannelId
​string[] · style: form · explode: true

optional package distribution channel ID filter, passed through to Orders distributionChannelId filter

endTime
​string[] · style: form · explode: true

optional package end-time filter, passed through to Orders endTime filter

externalReference
​string[] · style: form · explode: true

optional package external reference filter, passed through to Orders externalReference filter

fromStopPlaceId
​string[] · style: form · explode: true

optional package from stop place ID filter, passed through to Orders fromStopPlaceId filter

lastConfirmedAt
​string[] · style: form · explode: true

optional package last-confirmed-at filter, passed through to Orders lastConfirmedAt filter

orderBy
​string · style: form · explode: true

optional package orderBy value, passed through to Orders orderBy

legExternalReference
​string[] · style: form · explode: true

optional package leg external reference filter, mapped to Orders orderLineExternalReference

legId
​string[] · style: form · explode: true

optional package leg identifier filter, mapped to Orders orderLineId

organisationId
​string[] · style: form · explode: true

optional package organisation ID filter, passed through to Orders organisationId filter

originalDatedServiceJourneyId
​string[] · style: form · explode: true

optional package original dated service journey ID filter, passed through to Orders originalDatedServiceJourneyId filter

pos
​string[] · style: form · explode: true

optional package POS filter, passed through to Orders pos filter

reservationId
​string[] · style: form · explode: true

optional package reservation ID filter, passed through to Orders reservationId filter

productId
​string[] · style: form · explode: true

optional package product ID filter, mapped to Orders fareProductId

fareProductVersion
​string[] · style: form · explode: true

optional package fare product version filter, passed through to Orders fareProductVersion filter

serviceJourneyId
​string[] · style: form · explode: true

optional package service journey ID filter, passed through to Orders serviceJourneyId filter

sortBy
​string · style: form · explode: true

optional package sort direction (ASC or DESC), passed through to Orders sortBy

startTime
​string[] · style: form · explode: true

optional package start-time filter, passed through to Orders startTime filter

toStopPlaceId
​string[] · style: form · explode: true

optional package to stop place ID filter, passed through to Orders toStopPlaceId filter

totalAmount
​string[] · style: form · explode: true

optional package total amount filter, passed through to Orders totalAmount filter

totalTaxAmount
​string[] · style: form · explode: true

optional package total tax amount filter, passed through to Orders totalTaxAmount filter

version
​string[] · style: form · explode: true

optional package version filter, passed through to Orders version filter

status
​packageStatus · enum · style: form · explode: true

Filter 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.

Enum values:
OFFERED
SELECTED
PENDING
CONFIRMED
RELEASED
EXPIRED
CANCELLED
REFUND_CLAIMED

List purchased packages › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List purchased packages › Responses

A list of packages

type
​string · enum · required
Enum values:
PackageCollection
​package[] · required
numberMatched
​integer

Total number of packages available (for pagination)

numberReturned
​integer

Number of packages in this response

​link[]

Actions that can be performed on this collection.


Get package by ID

GET
https://api.entur.io/omsa/v1
/collections/packages/items/{packageId}

Retrieves a single package by identifier.

Get package by ID › path Parameters

packageId
​string · required · style: simple

The unique identifier of the package to retrieve

Get package by ID › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

Get package by ID › Responses

a geojson response, containing the package details in the main properties and the legs are represented in the features

a purchased package is a registration of an agreement between end user and TO, to execute a package (=set of legs) according a specification, including all conditions
type
​string · pattern: ^(package)$ · required
status
​packageStatus · enum · required

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.

Enum values:
OFFERED
SELECTED
PENDING
CONFIRMED
RELEASED
EXPIRED
CANCELLED
REFUND_CLAIMED
​amountOfMoney · required

an amount of money, usable in fares, fare calculations or in extra costs.

​offer[] · required
​placeReference[] · minItems: 0 · maxItems: 3

use an ID contained in the placeDefinitions field, or from an external source, when using coordinates, please use the prefix 'gps:'

startTime
​dateTime · date-time

https://www.rfc-editor.org/rfc/rfc3339#section-5.6, date-time (2019-10-12T07:20:50.52Z)

endTime
​dateTime · date-time

https://www.rfc-editor.org/rfc/rfc3339#section-5.6, date-time (2019-10-12T07:20:50.52Z)

​postalAddress[] · minItems: 0 · maxItems: 3

Places that are not specified in an external data source (like a home address)

id
​string
externalReference
​normalString · maxLength: 200

default string, full names etc (length 0-200)

guarantees
​normalString[]
​array
​link[]

List customers with filters

GET
https://api.entur.io/omsa/v1
/collections/customers/items

Retrieve customers with optional filters and pagination.

List customers with filters › query Parameters

limit
​integer · min: 1 · max: 10000 · style: form

The 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.

Default: 100
offset
​integer · min: 0 · style: form

The 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.

Default: 0
customerId
​normalString · maxLength: 200 · style: form · explode: true

optional customer identifier filter

default string, full names etc (length 0-200)

externalReference
​string · maxLength: 40 · style: form · explode: true

optional filter on the client's own customer reference

firstName
​shortString · maxLength: 75 · style: form · explode: true

optional first name filter

short string, display names (length 0-75)

lastName
​shortString · maxLength: 75 · style: form · explode: true

optional last name filter

short string, display names (length 0-75)

email
​normalString · maxLength: 200 · style: form · explode: true

optional email filter

default string, full names etc (length 0-200)

phoneNumber
​normalString · maxLength: 200 · style: form · explode: true

optional phone number filter

default string, full names etc (length 0-200)

List customers with filters › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

List customers with filters › Responses

a customer collection response

type
​string · enum · required
Enum values:
CustomerCollection
​customer[]
numberMatched
​integer
numberReturned
​integer
​link[]

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.


Create customer record

POST
https://api.entur.io/omsa/v1
/collections/customers/items

Create a customer record that can be used for purchases.

Create customer record › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

Create customer record › Request Body

Customer details supplied when creating or replacing a customer. The id is the Entur customer number, assigned by the Entur Customer Profiles service, and must not be set here.
firstName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

lastName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

initials
​tinyString · maxLength: 10

real short string, codes (length 0-10)

middleName
​shortString · maxLength: 75

short string, display names (length 0-75)

prefix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

postfix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

email
​normalString · maxLength: 200

default string, full names etc (length 0-200)

phoneNumber
​normalString · maxLength: 200

default string, full names etc (length 0-200)

​postalAddress

address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language

dateOfBirth
​date · full-date
placeOfBirth
​shortString · maxLength: 75

short string, display names (length 0-75)

countryOfBirth
​country · minLength: 2 · maxLength: 2 · pattern: [A-Z]{2}

two-letter country codes according to ISO 3166-1

​customProperties · maxProps: 20

dictionary for extra fields (bilatural agreements)

externalReference
​string · minLength: 1 · maxLength: 40

The client's own reference for this customer, unique within the organisation. Must not be blank. Leading and trailing whitespace is trimmed. Defaults to the customer number when not set. Can only be set when the customer is created. On replace it must be omitted or equal to the stored value. Use id, not this value, when referring to the customer elsewhere in the API.

Create customer record › Responses

a customer response

A customer record returned by the API.
firstName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

lastName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

id
​normalString · maxLength: 200 · required

default string, full names etc (length 0-200)

initials
​tinyString · maxLength: 10

real short string, codes (length 0-10)

middleName
​shortString · maxLength: 75

short string, display names (length 0-75)

prefix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

postfix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

email
​normalString · maxLength: 200

default string, full names etc (length 0-200)

phoneNumber
​normalString · maxLength: 200

default string, full names etc (length 0-200)

​postalAddress

address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language

dateOfBirth
​date · full-date
placeOfBirth
​shortString · maxLength: 75

short string, display names (length 0-75)

countryOfBirth
​country · minLength: 2 · maxLength: 2 · pattern: [A-Z]{2}

two-letter country codes according to ISO 3166-1

​customProperties · maxProps: 20

dictionary for extra fields (bilatural agreements)

externalReference
​string · minLength: 1 · maxLength: 40

The client's own reference for this customer, unique within the organisation. Must not be blank. Leading and trailing whitespace is trimmed. Defaults to the customer number when not set. Can only be set when the customer is created. On replace it must be omitted or equal to the stored value. Use id, not this value, when referring to the customer elsewhere in the API.


Get customer by ID

GET
https://api.entur.io/omsa/v1
/collections/customers/items/{customerId}

Retrieves a single customer by identifier.

Get customer by ID › path Parameters

customerId
​normalString · maxLength: 200 · required · style: simple

customer identifier

default string, full names etc (length 0-200)

Get customer by ID › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

Get customer by ID › Responses

a customer response

A customer record returned by the API.
firstName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

lastName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

id
​normalString · maxLength: 200 · required

default string, full names etc (length 0-200)

initials
​tinyString · maxLength: 10

real short string, codes (length 0-10)

middleName
​shortString · maxLength: 75

short string, display names (length 0-75)

prefix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

postfix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

email
​normalString · maxLength: 200

default string, full names etc (length 0-200)

phoneNumber
​normalString · maxLength: 200

default string, full names etc (length 0-200)

​postalAddress

address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language

dateOfBirth
​date · full-date
placeOfBirth
​shortString · maxLength: 75

short string, display names (length 0-75)

countryOfBirth
​country · minLength: 2 · maxLength: 2 · pattern: [A-Z]{2}

two-letter country codes according to ISO 3166-1

​customProperties · maxProps: 20

dictionary for extra fields (bilatural agreements)

externalReference
​string · minLength: 1 · maxLength: 40

The client's own reference for this customer, unique within the organisation. Must not be blank. Leading and trailing whitespace is trimmed. Defaults to the customer number when not set. Can only be set when the customer is created. On replace it must be omitted or equal to the stored value. Use id, not this value, when referring to the customer elsewhere in the API.


Replace customer record

PUT
https://api.entur.io/omsa/v1
/collections/customers/items/{customerId}

Replace the customer record.

Replace customer record › path Parameters

customerId
​normalString · maxLength: 200 · required · style: simple

customer identifier

default string, full names etc (length 0-200)

Replace customer record › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

Replace customer record › Request Body

Customer details supplied when creating or replacing a customer. The id is the Entur customer number, assigned by the Entur Customer Profiles service, and must not be set here.
firstName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

lastName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

initials
​tinyString · maxLength: 10

real short string, codes (length 0-10)

middleName
​shortString · maxLength: 75

short string, display names (length 0-75)

prefix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

postfix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

email
​normalString · maxLength: 200

default string, full names etc (length 0-200)

phoneNumber
​normalString · maxLength: 200

default string, full names etc (length 0-200)

​postalAddress

address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language

dateOfBirth
​date · full-date
placeOfBirth
​shortString · maxLength: 75

short string, display names (length 0-75)

countryOfBirth
​country · minLength: 2 · maxLength: 2 · pattern: [A-Z]{2}

two-letter country codes according to ISO 3166-1

​customProperties · maxProps: 20

dictionary for extra fields (bilatural agreements)

externalReference
​string · minLength: 1 · maxLength: 40

The client's own reference for this customer, unique within the organisation. Must not be blank. Leading and trailing whitespace is trimmed. Defaults to the customer number when not set. Can only be set when the customer is created. On replace it must be omitted or equal to the stored value. Use id, not this value, when referring to the customer elsewhere in the API.

Replace customer record › Responses

a customer response

A customer record returned by the API.
firstName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

lastName
​shortString · maxLength: 75 · required

short string, display names (length 0-75)

id
​normalString · maxLength: 200 · required

default string, full names etc (length 0-200)

initials
​tinyString · maxLength: 10

real short string, codes (length 0-10)

middleName
​shortString · maxLength: 75

short string, display names (length 0-75)

prefix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

postfix
​tinyString · maxLength: 10

real short string, codes (length 0-10)

email
​normalString · maxLength: 200

default string, full names etc (length 0-200)

phoneNumber
​normalString · maxLength: 200

default string, full names etc (length 0-200)

​postalAddress

address parts, where addressLine1 and 2 should contain the complete address, matches Content-Language

dateOfBirth
​date · full-date
placeOfBirth
​shortString · maxLength: 75

short string, display names (length 0-75)

countryOfBirth
​country · minLength: 2 · maxLength: 2 · pattern: [A-Z]{2}

two-letter country codes according to ISO 3166-1

​customProperties · maxProps: 20

dictionary for extra fields (bilatural agreements)

externalReference
​string · minLength: 1 · maxLength: 40

The client's own reference for this customer, unique within the organisation. Must not be blank. Leading and trailing whitespace is trimmed. Defaults to the customer number when not set. Can only be set when the customer is created. On replace it must be omitted or equal to the stored value. Use id, not this value, when referring to the customer elsewhere in the API.


Delete customer record

DELETE
https://api.entur.io/omsa/v1
/collections/customers/items/{customerId}

Delete the customer record.

Delete customer record › path Parameters

customerId
​normalString · maxLength: 200 · required · style: simple

customer identifier

default string, full names etc (length 0-200)

Delete customer record › Headers

Accept-Language
​shortString · maxLength: 75 · required · style: simple

short string, display names (length 0-75)

authorization
​string · required · style: simple

Header field, JWT must be supplied

ET-Client-Name
​string · style: simple

Entur 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>.

X-Correlation-Id
​string · style: simple

Correlation id

Delete customer record › Responses

Customer deleted successfully

No data returned

Did you find what you were looking for?