Supplement product

Server

A supplement product can be purchased in addition to a preassigned fare product. Examples of supplement product types include:

Seat reservation
Bicycle
Animal
Meal
Wi-fi
Luggage
Parking

Create a new supplement product

POST

https://api.entur.io/products

/v3/supplement-products

Create a new supplement product. A new version will be created with version number 1.

Create a new supplement product › Headers

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 a new supplement product › Request Body

SupplementProductRequest

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product. Defaults to VERSIONED.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

VAT group type. This is used to determine which VAT rate applies to a product. The VAT group type is determined by the product type and the country of sale. For example, in Norway, food products are subject to a reduced VAT rate of 15%, while other products are subject to the standard VAT rate of 25%. In this case, food products would be classified as FOOD_VAT, while other products would be classified as GENERAL_VAT.

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

privateCodes

string[]

Optional external system identifiers.

Default: []

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.

object[]

endDate

string · date

The end date of the version (optional).

FareTableRef[]

References to the versioned FareTable instances that price this supplement product.

The priceable object owns this link (as in products-spring): supply the fare tables that price it here on write. Prices themselves live on the fare table — create/update them via the pricing/fare-table API, then reference the fare table here. On read, SupplementProductResponse surfaces the resolved fare-table NeTEx ids.

Default: []

Create a new supplement product › Responses

Supplement product created successfully

SupplementProductResponse

id

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

The NeTEx ID of the supplement product.

Example: BNR:SupplementProduct:123

versionId

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

The netex id reference to the object.

Example: EXA:Version:001

privateCodes

string[] · required

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · required

Internal id of the organisation that owns this supplement product.

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

versionNumber

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

object

The datasource that owns this supplement product.

object[]

endDate

string · date

The end date of the version (optional).

fareTableRefs

string[] · readOnly

NeTEx IDs of the FareTable instances that price this supplement product.

Read-only. Prices themselves are not exposed here; use the pricing/fare-table API with these references to retrieve the actual prices. This lets clients discover the relevant fare tables for a priceable object directly, without fetching and scanning every fare table.

Default: []

POST/v3/supplement-products

curl https://api.entur.io/products/v3/supplement-products \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "ownerOrganisationId": 1,
  "names": [
    {
      "lang": "en-GB",
      "value": "Bike reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Sykkelreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Valid on the given departure and require a valid ticket for traveller who brings the bike."
    },
    {
      "lang": "nb-NO",
      "value": "Gyldig på en gitt avgang og krever gyldig billett for den reisende som reiser med sykkel."
    }
  ],
  "status": "DRAFT",
  "startDate": "2025-01-01",
  "supplementProductType": "BICYCLE",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": true,
    "refundable": true,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:DuringTravel",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:SingleTicket",
    "EXA:EntitlementRequired:PeriodTicket"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "LINE",
      "validityParameterRefs": [
        "EXA:Line:X1"
      ]
    }
  ]
}'

Example Request Body

{
  "ownerOrganisationId": 1,
  "names": [
    {
      "lang": "en-GB",
      "value": "Bike reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Sykkelreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Valid on the given departure and require a valid ticket for traveller who brings the bike."
    },
    {
      "lang": "nb-NO",
      "value": "Gyldig på en gitt avgang og krever gyldig billett for den reisende som reiser med sykkel."
    }
  ],
  "status": "DRAFT",
  "startDate": "2025-01-01",
  "supplementProductType": "BICYCLE",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": true,
    "refundable": true,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:DuringTravel",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:SingleTicket",
    "EXA:EntitlementRequired:PeriodTicket"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "LINE",
      "validityParameterRefs": [
        "EXA:Line:X1"
      ]
    }
  ]
}

json

application/json

Example Responses

{
  "privateCodes": [
    "123"
  ],
  "id": "EXA:SupplementProduct:456",
  "versionId": "EXA:Version:07ce871e-b84d-47c0-99ba-c7fdb5fa4df9",
  "versionNumber": 1,
  "ownerOrganisationId": 47,
  "datasource": {
    "id": "some-client-system"
  },
  "status": "VERSIONED",
  "startDate": "2025-01-01",
  "names": [
    {
      "lang": "en-GB",
      "value": "Parking reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Parkeringsreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Reserve a parking spot at the station."
    },
    {
      "lang": "nb-NO",
      "value": "Reserver parkeringsplass på stasjonen."
    }
  ],
  "supplementProductType": "PARKING",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": false,
    "refundable": false,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:30days",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:PeriodTicket30days"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "PARKING",
      "validityParameterRefs": [
        "NSR:Parking:P01",
        "NSR:Parking:P02",
        "NSR:Parking:P03"
      ]
    }
  ],
  "fareTableRefs": [
    "EXA:FareTable:parking-2025"
  ]
}

json

application/json

Get the active version of a supplement product

GET

https://api.entur.io/products

/v3/supplement-products/{id}

Retrieve the version of the supplement product that is active on the given date.

Get the active version of a supplement product › path Parameters

id

string · pattern: ^([A-Z]{3}):([A-Za-z… · required · style: simple

The netex ID of the element to retrieve

Get the active version of a supplement product › query Parameters

validOnDate

string · date · style: form · explode: true

The date that the element should be valid for, e.g. the travel date. Defaults to the current date.

Get the active version of a supplement product › Headers

ET-Client-Name

string · style: simple

X-Correlation-Id

string · style: simple

Correlation id

Get the active version of a supplement product › Responses

The supplement product version active on the given date.

SupplementProductResponse

id

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

The NeTEx ID of the supplement product.

Example: BNR:SupplementProduct:123

versionId

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

The netex id reference to the object.

Example: EXA:Version:001

privateCodes

string[] · required

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · required

Internal id of the organisation that owns this supplement product.

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

versionNumber

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

object

The datasource that owns this supplement product.

object[]

endDate

string · date

The end date of the version (optional).

fareTableRefs

string[] · readOnly

NeTEx IDs of the FareTable instances that price this supplement product.

Default: []

GET/v3/supplement-products/{id}

curl https://api.entur.io/products/v3/supplement-products/:id \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "privateCodes": [
    "123"
  ],
  "id": "EXA:SupplementProduct:456",
  "versionId": "EXA:Version:07ce871e-b84d-47c0-99ba-c7fdb5fa4df9",
  "versionNumber": 1,
  "ownerOrganisationId": 47,
  "datasource": {
    "id": "some-client-system"
  },
  "status": "VERSIONED",
  "startDate": "2025-01-01",
  "names": [
    {
      "lang": "en-GB",
      "value": "Parking reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Parkeringsreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Reserve a parking spot at the station."
    },
    {
      "lang": "nb-NO",
      "value": "Reserver parkeringsplass på stasjonen."
    }
  ],
  "supplementProductType": "PARKING",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": false,
    "refundable": false,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:30days",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:PeriodTicket30days"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "PARKING",
      "validityParameterRefs": [
        "NSR:Parking:P01",
        "NSR:Parking:P02",
        "NSR:Parking:P03"
      ]
    }
  ],
  "fareTableRefs": [
    "EXA:FareTable:parking-2025"
  ]
}

json

application/json

Create a new version of a supplement product

POST

https://api.entur.io/products

/v3/supplement-products/{id}

Create a new version of existing supplement product. The added version will be in DRAFT status, and will be created with version number n+1. The version will not be active until a start date is set and the version is published.

Create a new version of a supplement product › path Parameters

id

string · pattern: ^([A-Z]{3}):([A-Za-z… · required · style: simple

The netex ID of the element to retrieve

Create a new version of a supplement product › Headers

ET-Client-Name

string · style: simple

X-Correlation-Id

string · style: simple

Correlation id

Create a new version of a supplement product › Request Body

SupplementProductRequest

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product. Defaults to VERSIONED.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

privateCodes

string[]

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · min: 1

object[]

endDate

string · date

The end date of the version (optional).

FareTableRef[]

References to the versioned FareTable instances that price this supplement product.

Default: []

Create a new version of a supplement product › Responses

Supplement product created successfully

SupplementProductResponse

id

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

The NeTEx ID of the supplement product.

Example: BNR:SupplementProduct:123

versionId

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

The netex id reference to the object.

Example: EXA:Version:001

privateCodes

string[] · required

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · required

Internal id of the organisation that owns this supplement product.

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

versionNumber

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

object

The datasource that owns this supplement product.

object[]

endDate

string · date

The end date of the version (optional).

fareTableRefs

string[] · readOnly

NeTEx IDs of the FareTable instances that price this supplement product.

Default: []

POST/v3/supplement-products/{id}

curl https://api.entur.io/products/v3/supplement-products/:id \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "ownerOrganisationId": 1,
  "names": [
    {
      "lang": "en-GB",
      "value": "Bike reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Sykkelreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Valid on the given departure and require a valid ticket for traveller who brings the bike."
    },
    {
      "lang": "nb-NO",
      "value": "Gyldig på en gitt avgang og krever gyldig billett for den reisende som reiser med sykkel."
    }
  ],
  "status": "DRAFT",
  "startDate": "2025-01-01",
  "supplementProductType": "BICYCLE",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": true,
    "refundable": true,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:DuringTravel",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:SingleTicket",
    "EXA:EntitlementRequired:PeriodTicket"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "LINE",
      "validityParameterRefs": [
        "EXA:Line:X1"
      ]
    }
  ]
}'

Example Request Body

{
  "ownerOrganisationId": 1,
  "names": [
    {
      "lang": "en-GB",
      "value": "Bike reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Sykkelreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Valid on the given departure and require a valid ticket for traveller who brings the bike."
    },
    {
      "lang": "nb-NO",
      "value": "Gyldig på en gitt avgang og krever gyldig billett for den reisende som reiser med sykkel."
    }
  ],
  "status": "DRAFT",
  "startDate": "2025-01-01",
  "supplementProductType": "BICYCLE",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": true,
    "refundable": true,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:DuringTravel",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:SingleTicket",
    "EXA:EntitlementRequired:PeriodTicket"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "LINE",
      "validityParameterRefs": [
        "EXA:Line:X1"
      ]
    }
  ]
}

json

application/json

Example Responses

{
  "privateCodes": [
    "123"
  ],
  "id": "EXA:SupplementProduct:456",
  "versionId": "EXA:Version:07ce871e-b84d-47c0-99ba-c7fdb5fa4df9",
  "versionNumber": 1,
  "ownerOrganisationId": 47,
  "datasource": {
    "id": "some-client-system"
  },
  "status": "VERSIONED",
  "startDate": "2025-01-01",
  "names": [
    {
      "lang": "en-GB",
      "value": "Parking reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Parkeringsreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Reserve a parking spot at the station."
    },
    {
      "lang": "nb-NO",
      "value": "Reserver parkeringsplass på stasjonen."
    }
  ],
  "supplementProductType": "PARKING",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": false,
    "refundable": false,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:30days",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:PeriodTicket30days"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "PARKING",
      "validityParameterRefs": [
        "NSR:Parking:P01",
        "NSR:Parking:P02",
        "NSR:Parking:P03"
      ]
    }
  ],
  "fareTableRefs": [
    "EXA:FareTable:parking-2025"
  ]
}

json

application/json

List versions of a supplement product

GET

https://api.entur.io/products

/v3/supplement-products/{id}/versions

Retrieve all versions of a supplement product by its NeTEx ID, including drafts and proposals.

List versions of a supplement product › path Parameters

id

string · pattern: ^([A-Z]{3}):([A-Za-z… · required · style: simple

The netex ID of the element to retrieve

List versions of a supplement product › Headers

ET-Client-Name

string · style: simple

X-Correlation-Id

string · style: simple

Correlation id

List versions of a supplement product › Responses

List of supplement product versions

VersionResponse[]

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

GET/v3/supplement-products/{id}/versions

curl https://api.entur.io/products/v3/supplement-products/:id/versions \
  --header 'Authorization: Bearer <token>'

Example Responses

[
  {
    "id": "EXA:Version:853a7d14-794e-4af5-b569-301711a26e26",
    "status": "VERSIONED",
    "startDate": "2025-01-01",
    "endDate": "2025-12-31",
    "created": "2024-12-01T10:00:00Z",
    "changed": "2024-12-01T10:00:00Z",
    "published": "2024-12-30T10:00:00Z",
    "number": 1
  },
  {
    "id": "EXA:Version:e7104d26-16a5-4db5-aa42-b32ae0a3f684",
    "status": "VERSIONED",
    "startDate": "2026-01-01",
    "created": "2025-12-01T10:00:00Z",
    "changed": "2025-12-01T10:00:00Z",
    "published": "2025-12-01T13:00:00Z",
    "number": 2
  },
  {
    "id": "EXA:Version:6be856a5-dd98-496b-b3f2-ad9939270ec3",
    "status": "PROPOSED",
    "startDate": "2026-07-01",
    "created": "2026-06-01T10:00:00Z",
    "changed": "2026-06-01T10:00:00Z"
  }
]

json

application/json

Get a supplement product version

GET

https://api.entur.io/products

/v3/supplement-products/{id}/{version}

Retrieve the complete supplement product for a specific version, identified by NeTEx version ID or version number.

Get a supplement product version › path Parameters

id

string · pattern: ^([A-Z]{3}):([A-Za-z… · required · style: simple

The netex ID of the element to retrieve

version

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

The netex ID or sequence number of the version to retrieve

Get a supplement product version › Headers

ET-Client-Name

string · style: simple

X-Correlation-Id

string · style: simple

Correlation id

Get a supplement product version › Responses

Supplement product version found

SupplementProductResponse

id

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

The NeTEx ID of the supplement product.

Example: BNR:SupplementProduct:123

versionId

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

The netex id reference to the object.

Example: EXA:Version:001

privateCodes

string[] · required

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · required

Internal id of the organisation that owns this supplement product.

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

versionNumber

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

object

The datasource that owns this supplement product.

object[]

endDate

string · date

The end date of the version (optional).

fareTableRefs

string[] · readOnly

NeTEx IDs of the FareTable instances that price this supplement product.

Default: []

GET/v3/supplement-products/{id}/{version}

curl https://api.entur.io/products/v3/supplement-products/:id/:version \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "privateCodes": [
    "123"
  ],
  "id": "EXA:SupplementProduct:456",
  "versionId": "EXA:Version:07ce871e-b84d-47c0-99ba-c7fdb5fa4df9",
  "versionNumber": 1,
  "ownerOrganisationId": 47,
  "datasource": {
    "id": "some-client-system"
  },
  "status": "VERSIONED",
  "startDate": "2025-01-01",
  "names": [
    {
      "lang": "en-GB",
      "value": "Parking reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Parkeringsreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Reserve a parking spot at the station."
    },
    {
      "lang": "nb-NO",
      "value": "Reserver parkeringsplass på stasjonen."
    }
  ],
  "supplementProductType": "PARKING",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": false,
    "refundable": false,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:30days",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:PeriodTicket30days"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "PARKING",
      "validityParameterRefs": [
        "NSR:Parking:P01",
        "NSR:Parking:P02",
        "NSR:Parking:P03"
      ]
    }
  ],
  "fareTableRefs": [
    "EXA:FareTable:parking-2025"
  ]
}

json

application/json

Update a version of a supplement product

PUT

https://api.entur.io/products

/v3/supplement-products/{id}/{version}

Update the version of a supplement product. The version will not be active until a start date is set and the version is published.

Update a version of a supplement product › path Parameters

id

string · pattern: ^([A-Z]{3}):([A-Za-z… · required · style: simple

The netex ID of the element to retrieve

version

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

The netex ID or sequence number of the version to retrieve

Update a version of a supplement product › Headers

ET-Client-Name

string · style: simple

X-Correlation-Id

string · style: simple

Correlation id

Update a version of a supplement product › Request Body

SupplementProductRequest

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product. Defaults to VERSIONED.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

privateCodes

string[]

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · min: 1

object[]

endDate

string · date

The end date of the version (optional).

FareTableRef[]

References to the versioned FareTable instances that price this supplement product.

Default: []

Update a version of a supplement product › Responses

Supplement product updated successfully

SupplementProductResponse

id

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

The NeTEx ID of the supplement product.

Example: BNR:SupplementProduct:123

versionId

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

The netex id reference to the object.

Example: EXA:Version:001

privateCodes

string[] · required

Optional external system identifiers.

Default: []

ownerOrganisationId

integer · int64 · required

Internal id of the organisation that owns this supplement product.

object[] · required

startDate

string · date · required

The start date of the version.

status

string · enum · required

Status of the supplement product.

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

chargingMomentType

ChargingMomentType · enum · required

Charging moment type.

Note: Currently, only BEFORE_TRAVEL is supported in Entur sales platform.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_END_OF_TRAVEL

BEFORE_TRAVEL_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_TRAVEL

ON_START_THEN_ADJUST_AT_END_OF_FARE_DAY

ON_START_THEN_ADJUST_AT_END_OF_CHARGE_PERIOD

AT_END_OF_TRAVEL

supplementProductType

SupplementProductType · enum · required

The type of the supplement product. This can be used to determine which parameters are relevant for the product.

Enum values:

SEAT_RESERVATION

BICYCLE

DOG

ANIMAL

MEAL

WIFI

EXTRA_LUGGAGE

PENALTY

ConditionsSummary · required

vatGroup

VatGrpupType · enum · required

Enum values:

EXCEPTION_FROM_VAT

GENERAL_VAT

FOOD_VAT

TRANSPORT_AND_TICKETS_VAT

Default: TRANSPORT_AND_TICKETS_VAT

purchaseWindowRef

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

NeTEx ID of a PurchaseWindow instance (Product Parameters API, /v3/parameters/purchase-windows). Available values are listed in the Product Parameters API.

Example: ENT:PurchaseWindow:120days

usageValidityPeriodRef

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

NeTEx ID of a UsageValidityPeriod instance (limitations/usage-validity-period). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

Example: ENT:UsageValidityPeriod:DuringTravel

entitlementRequiredRefs

string[] · minItems: 1 · required

List of NeTEx IDs of EntitlementRequired instances (limitations/entitlement-required). Available values are listed in the Product Parameters API.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

ValidityParameters[] · required

List of validity parameters. The specified parameter tells where the supplement product is valid. This can be lines, zones, stops etc.

Not yet implemented: this endpoint currently accepts but does not persist or return this field.

versionNumber

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

object

The datasource that owns this supplement product.

object[]

endDate

string · date

The end date of the version (optional).

fareTableRefs

string[] · readOnly

NeTEx IDs of the FareTable instances that price this supplement product.

Default: []

PUT/v3/supplement-products/{id}/{version}

curl https://api.entur.io/products/v3/supplement-products/:id/:version \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "ownerOrganisationId": 1,
  "names": [
    {
      "lang": "en-GB",
      "value": "Bike reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Sykkelreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Valid on the given departure and require a valid ticket for traveller who brings the bike."
    },
    {
      "lang": "nb-NO",
      "value": "Gyldig på en gitt avgang og krever gyldig billett for den reisende som reiser med sykkel."
    }
  ],
  "status": "DRAFT",
  "startDate": "2025-01-01",
  "supplementProductType": "BICYCLE",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": true,
    "refundable": true,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:DuringTravel",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:SingleTicket",
    "EXA:EntitlementRequired:PeriodTicket"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "LINE",
      "validityParameterRefs": [
        "EXA:Line:X1"
      ]
    }
  ]
}'

Example Request Body

{
  "ownerOrganisationId": 1,
  "names": [
    {
      "lang": "en-GB",
      "value": "Bike reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Sykkelreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Valid on the given departure and require a valid ticket for traveller who brings the bike."
    },
    {
      "lang": "nb-NO",
      "value": "Gyldig på en gitt avgang og krever gyldig billett for den reisende som reiser med sykkel."
    }
  ],
  "status": "DRAFT",
  "startDate": "2025-01-01",
  "supplementProductType": "BICYCLE",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": true,
    "refundable": true,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:DuringTravel",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:SingleTicket",
    "EXA:EntitlementRequired:PeriodTicket"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "LINE",
      "validityParameterRefs": [
        "EXA:Line:X1"
      ]
    }
  ]
}

json

application/json

Example Responses

{
  "privateCodes": [
    "123"
  ],
  "id": "EXA:SupplementProduct:456",
  "versionId": "EXA:Version:07ce871e-b84d-47c0-99ba-c7fdb5fa4df9",
  "versionNumber": 1,
  "ownerOrganisationId": 47,
  "datasource": {
    "id": "some-client-system"
  },
  "status": "VERSIONED",
  "startDate": "2025-01-01",
  "names": [
    {
      "lang": "en-GB",
      "value": "Parking reservation"
    },
    {
      "lang": "nb-NO",
      "value": "Parkeringsreservasjon"
    }
  ],
  "descriptions": [
    {
      "lang": "en-GB",
      "value": "Reserve a parking spot at the station."
    },
    {
      "lang": "nb-NO",
      "value": "Reserver parkeringsplass på stasjonen."
    }
  ],
  "supplementProductType": "PARKING",
  "chargingMomentType": "BEFORE_TRAVEL",
  "conditionsSummary": {
    "exchangeable": false,
    "refundable": false,
    "fareStructureType": "NETWORK_FLAT_FARE"
  },
  "vatGroup": "TRANSPORT_AND_TICKETS_VAT",
  "purchaseWindowRef": "EXA:PurchaseWindow:120days",
  "usageValidityPeriodRef": "EXA:UsageValidityPeriod:30days",
  "entitlementRequiredRefs": [
    "EXA:EntitlementRequired:PeriodTicket30days"
  ],
  "validityParameters": [
    {
      "groupingType": "OR",
      "validityParameterType": "PARKING",
      "validityParameterRefs": [
        "NSR:Parking:P01",
        "NSR:Parking:P02",
        "NSR:Parking:P03"
      ]
    }
  ],
  "fareTableRefs": [
    "EXA:FareTable:parking-2025"
  ]
}

json

application/json

Entitlement Required Sales package assignment

Did you find what you were looking for?

Supplement product

Create a new supplement product

Create a new supplement product › Headers

Create a new supplement product › Request Body

Create a new supplement product › Responses

Get the active version of a supplement product

Get the active version of a supplement product › path Parameters

Get the active version of a supplement product › query Parameters

Get the active version of a supplement product › Headers

Get the active version of a supplement product › Responses

Create a new version of a supplement product

Create a new version of a supplement product › path Parameters

Create a new version of a supplement product › Headers

Create a new version of a supplement product › Request Body

Create a new version of a supplement product › Responses

List versions of a supplement product

List versions of a supplement product › path Parameters

List versions of a supplement product › Headers

List versions of a supplement product › Responses

Get a supplement product version

Get a supplement product version › path Parameters

Get a supplement product version › Headers

Get a supplement product version › Responses

Update a version of a supplement product

Update a version of a supplement product › path Parameters

Update a version of a supplement product › Headers

Update a version of a supplement product › Request Body

Update a version of a supplement product › Responses

Build with Entur

Contribute

Terms & Policies