Entur Developer
Pricing

LocalizedString

​object[]
lang
​string · pattern: ^[a-z]{2}-[A-Z]{2}$ · required

BCP-47 language tag (e.g., 'nb-NO', 'en-GB').

Example: nb-NO
value
​string · required

The localized string value for the specified lang.

VersionStatus

string · enum
Enum values:
DRAFT
PROPOSED
VERSIONED
DEPRECATED

FarePriceType

string · enum
Enum values:
FlatPrice

Discriminator for a fare table price cell. Only the flat FlatPrice (a fixed amount with no selectors, NeTEx FarePrice) is implemented today; DistanceMatrixElementPrice and GeographicalIntervalPrice will be added as sibling types when the price model is extended beyond flat prices.

Example: FlatPrice

FarePriceEntry

A single NeTEx-typed price, held as a cell of the fare table. Each price is an explicit NeTEx price object identified by its `type` (the NeTEx class). Only the flat `FlatPrice` is implemented today: a fixed amount with no origin/destination, interval or passenger-type selectors. The richer NeTEx price types — `DistanceMatrixElementPrice` for an origin/destination pair, `GeographicalIntervalPrice` for a counted interval, each optionally carrying a `LimitingRule` for discounts and caps — will be added as sibling `type`s when the model is extended, so clients can already branch on `type`.
type
​FarePriceType · enum · required

Discriminator for a fare table price cell. Only the flat FlatPrice (a fixed amount with no selectors, NeTEx FarePrice) is implemented today; DistanceMatrixElementPrice and GeographicalIntervalPrice will be added as sibling types when the price model is extended beyond flat prices.

Enum values:
FlatPrice
Example: FlatPrice
amount
​string · pattern: ^[0-9]+(\.[0-9]+)?$ · required

The price in the major unit of this entry's currency, as a decimal string (for example "49.00"). The number of decimals must not exceed what that currency allows — 2 for NOK and EUR, 0 for JPY, 3 for KWD.

Example: 49.00
currency
​string · pattern: ^[A-Z]{3}$ · required

ISO 4217 currency code for this individual price, per NeTEx FarePrice.Currency. Required: the flat amount cannot be interpreted without knowing its currency (the number of decimals depends on it). Different entries in the same fare table may declare different currencies.

Example: NOK

FareTableRequest

startDate
​string · date · required

First day this price version is valid.

Example: 2026-08-01
status
​string · enum · required

Status of the fare table version. Required; on create only DRAFT or PROPOSED is accepted — a new version cannot be published directly.

  • DRAFT - Under construction and not ready for operational use.
  • PROPOSED - Complete but pending review and approval.
  • VERSIONED - Finalized and frozen; a new version must be created for further modifications. Remains authoritative for its validity period even after expiry.
  • DEPRECATED - Explicitly withdrawn and should not be used; indicates an active decision to retract, not a natural expiry.
Enum values:
DRAFT
PROPOSED
VERSIONED
DEPRECATED
Example: DRAFT
​FarePriceEntry[] · minItems: 1 · required

The prices in this table. Each entry must be uniquely identified by its selector combination, so a flat price with no passenger-type differentiation is a single selector-less entry. Each entry carries its own optional currency, per NeTEx.

ownerOrganisationId
​integer · int64 · min: 1

Internal id of the organisation that owns this element. Omit it to use the organisation in the access token, which is what a caller acting for itself should do. Supplying a different organisation requires permission to act on behalf of that organisation.

Example: 1
​object[]
​object[]
endDate
​string · date

Last day this price version is valid (optional). Omit for an open-ended version.

Example: 2026-12-31

FareTableResponse

id
​string · pattern: ^([A-Z]{3}):FareTabl… · required

NeTEx id of the fare table.

Example: ENT:FareTable:bike-supplement
versionId
​string · pattern: ^([A-Z]{3}):Version:… · required

NeTEx id of this fare table version.

Example: ENT:Version:8f1b2c3d
ownerOrganisationId
​integer · int64 · required

Internal id of the organisation that owns this fare table.

Example: 1
startDate
​string · date · required

First day this price version is valid.

Example: 2026-08-01
status
​string · enum · required

Status of the fare table version.

  • DRAFT - Under construction and not ready for operational use.
  • PROPOSED - Complete but pending review and approval.
  • VERSIONED - Finalized and frozen; a new version must be created for further modifications. Remains authoritative for its validity period even after expiry.
  • DEPRECATED - Explicitly withdrawn and should not be used; indicates an active decision to retract, not a natural expiry.
Enum values:
DRAFT
PROPOSED
VERSIONED
DEPRECATED
Example: VERSIONED
​FarePriceEntry[] · required

The prices in this table. Each entry echoes its own currency, per NeTEx FarePrice.Currency.

​object[]
​object[]
endDate
​string · date

Last day this price version is valid (optional). Omit for an open-ended version.

Example: 2026-12-31
pricesFor
​string[] · readOnly

NeTEx ids of the priceable objects (e.g. supplement products) this fare table prices — NeTEx FareTable.pricesFor.

The FareTable → PriceableObject link is deliberately loose: a versioned fare table prices a priceable object by netex id only, never pinned to a specific priceable object version. Version resolution happens later, when the product tree is built.

Default: []

ProblemDetails

RFC 9457 Problem Details
type
​string · uri · required

A URI reference that identifies the problem type.

Example: https://developer.entur.org/errors/bad-request
title
​string · required

Short, human-readable summary of the problem type.

Example: Bad Request
status
​integer · int32 · required

The HTTP status code.

Example: 400
detail
​string · required

Human-readable explanation specific to this occurrence.

Example: The supplied ruleId is not a valid UUID.
instance
​string · uri

A URI reference that identifies the specific occurrence.

Example: https://api.example.com/requests/12345

VersionResponse

id
​string · pattern: ^([A-Z]{3}):Version:… · required

The netex id reference to the object.

Example: EXA:Version:001
status
​VersionStatus · enum · required
Enum values:
DRAFT
PROPOSED
VERSIONED
DEPRECATED
startDate
​string · date · required

The start date of the version.

created
​string · date-time · required

Created datetime

changed
​string · date-time · required

Changed datetime

number
​integer · int64

Version number of the version. Only present when versionStatus is VERSIONED. Starts at 1 for a new product and is incremented by 1 for each new version.

Example: 1
endDate
​string · date

The end date of the version.

published
​string · date-time

Timestamp for when the version was published (set to status VERSIONED).

VersionRequest

status
​string · enum · required

Must be DRAFT for new versions.

Enum values:
DRAFT
PROPOSED
VERSIONED
DEPRECATED
startDate
​string · date · required

The start date of the version. Defaults to current date if not provided.

endDate
​string · date

The end date of the version (optional).

ownerOrganisationId
​integer · int64 · min: 1

Internal id of the organisation that owns this element. Omit it to use the organisation in the access token, which is what a caller acting for itself should do. Supplying a different organisation requires permission to act on behalf of that organisation.

Did you find what you were looking for?