fare-products

Server

Download schema

Retrieves all fare-products, filtered by given parameter(s)

GET

https://api.entur.io/products

/fare-products

Retrieves all fare-products, filtered by given parameter(s) › query Parameters

orgId

string · style: form · explode: true

The unique id to identify a organisation

fareFrameId

string · style: form · explode: true

The unique id to identify data owned by organisation

typeOfFareProductId

string · style: form · explode: true

The unique id to identify the type of fare product

minimizeDataLoad

boolean · style: form · explode: true

gpaDataSet

string · style: form · explode: true

Deprecated: this parameter is ignored. Only E-variant GPAs are returned.

statusFilter

string[] · style: form · explode: true

Filter by status. Allowed values: DRAFT, PROPOSED, VERSIONED, DEPRECATED, ALL. Defaults to ALL if not specified. Mutually exclusive with validOnDate.

validOnDate

string · style: form · explode: true

Return the FareProducts valid on this date, example: 2024-06-01T00:00:00Z. Note that, if called in the production environment, only VERSIONED FareProducts are returned. And in the staging environment, PROPOSED FareProducts are preferred to VERSIONED ones. Mutually exclusive with statusFilter.

Retrieves all fare-products, filtered by given parameter(s) › 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

Accept-Language

string · style: simple

The language code from ISO-639-3

If-None-Match

string · style: simple

Used to make conditional requests. It allows the client to provide an ETag value, and the server will process the request only if the ETag does not match the current version of the resource.

Retrieves all fare-products, filtered by given parameter(s) › Responses

Returns the info

FareProduct[]

A FARE PRODUCT response consisting of one or several VALIDABLE ELEMENTs, specific to a CHARGING MOMENT

FareProduct

GenericParameterAssignment[] · required

AccessRightParameterAssignments.

AccessRightInProduct[] · required

AccessRightsInProduct.

changed

string · required

SalesPackage changed datetime.

created

string · required

SalesPackage create datetime.

VersionOfObjectRef · required

Fare frame ref.

id

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

Id.

Example: RUT:PreassignedFareProduct:RuterSingleTicket

modification

string · enum · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

nameOfClass

string · required

Name of class.

Example: PreassignedFareProduct

status

string · enum · required

Status

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

ValidityCondition[] · required

ValidityCondition.

activeComparisonOperatorVariant

string

Deprecated: this parameter will be ignored.

Example: E

chargingMomentType

string · enum

ChargingMomentType. Default value is BEFORE_TRAVEL.

Enum values:

BEFORE_TRAVEL

ON_START_OF_TRAVEL

BEFORE_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

AT_END_OF_CHARGE_PERIOD

Example: BEFORE_TRAVEL

compatibleWithVersionRef

string

CompatibleWithVersionRef

ConditionSummary

A summary of a condition.

derivedFromVersionRef

string

Derived from version.

TextInLanguage[]

Description represented in different languages. Language codes are ISO-639.

fareStructureType

string · enum

FareStructureType.

Enum values:

CAPPED_FLAT_FARE

CAPPED_POINT_TO_POINT_FARE

CAPPED_ZONAL_FARE

LINE_FLAT_FARE

NETWORK_FLAT_FARE

POINT_TO_POINT_FARE

POINT_TO_POINT_DISTANCE_FARE

STAGE_FARE

Example: ZONE_TO_ZONE_FARE

VersionOfObjectRef[]

FareTableRef.

VersionOfObjectRef

Fare frame ref.

TextInLanguage[]

Name represented in different languages. Language codes are ISO-639.

operatorRef

string

OperatorRef.

Example: RUT:Authority:RUT

organisation

string

Organisation who own the product.

organisationId

string

Organisation related to the fareProduct

privateCode

string

PrivateCode.

TypeOfFareProduct

A classification of FARE PRODUCTs.

version

string · minLength: 1 · pattern: ^([A-Z]{3}):([A-Za-z…

Version

Example: NSB:Version:V1

GET/fare-products

curl https://api.entur.io/products/fare-products

Example Responses

[
  {
    "accessRightParameterAssignments": [
      {
        "canIgnoreInOffering": true,
        "changed": "changed",
        "chargingBasisType": "FREE",
        "comparisonOperatorVariant": "E",
        "compatibleWithVersionRef": "NSB:Version:V1",
        "created": "created",
        "derivedFromVersionRef": "NSB:Version:V1",
        "description": [
          {
            "lang": "nob",
            "value": "value"
          }
        ],
        "fareFrameRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "fareProductRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "fareStructureElementRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "id": "NSB:GenericParameterAssignment:AllowedOperators",
        "includes": [
          null
        ],
        "includesGroupingType": "AND",
        "limitationGroupingType": "AND",
        "limitations": [
          {
            "nameOfClass": "nameOfClass",
            "ref": "ref",
            "version": "version"
          }
        ],
        "modification": "NEW",
        "name": [
          {
            "lang": "nob",
            "value": "value"
          }
        ],
        "nameOfClass": "GenericParameterAssignment",
        "parentParameterAssignmentRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "requiredElements": [
          "string"
        ],
        "requiredInContext": "OFFERING",
        "requiredType": "SERVICE_JOURNEY_REF",
        "salesPackageRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "status": "DRAFT",
        "temporalValidityParameters": [
          {
            "changed": "changed",
            "compatibleWithVersionRef": "compatibleWithVersionRef",
            "created": "created",
            "dayType": {
              "nameOfClass": "nameOfClass",
              "ref": "ref",
              "version": "version"
            },
            "derivedFromVersionRef": "derivedFromVersionRef",
            "genericParameterAssignmentRef": {
              "nameOfClass": "nameOfClass",
              "ref": "ref",
              "version": "version"
            },
            "groupOfTimeBands": {
              "changed": "changed",
              "compatibleWithVersionRef": "compatibleWithVersionRef",
              "created": "created",
              "derivedFromVersionRef": "derivedFromVersionRef",
              "id": "id",
              "members": [
                {
                  "changed": "changed",
                  "compatibleWithVersionRef": "compatibleWithVersionRef",
                  "created": "created",
                  "dayOffset": 1,
                  "derivedFromVersionRef": "derivedFromVersionRef",
                  "description": [
                    {
                      "lang": "nob",
                      "value": "value"
                    }
                  ],
                  "endTime": "11:11:11",
                  "fareFrameRef": {
                    "nameOfClass": "nameOfClass",
                    "ref": "ref",
                    "version": "version"
                  },
                  "id": "NSB:Timeband:2HoursValidPlus1",
                  "modification": "NEW",
                  "name": [
                    {
                      "lang": "nob",
                      "value": "value"
                    }
                  ],
                  "nameOfClass": "TimeBand",
                  "startTime": "11:11:11",
                  "status": "DRAFT",
                  "timeZone": "Europe/Oslo",
                  "validityConditions": [
                    {
                      "changed": "changed",
                      "created": "created",
                      "fromDate": "fromDate",
                      "id": "NSB:ValidBetween:2018",
                      "modification": "NEW",
                      "nameOfClass": "ValidBetween",
                      "status": "DRAFT",
                      "toDate": "toDate",
                      "version": "NSB:Version:V1"
                    }
                  ],
                  "version": "NSB:Version:V1"
                }
              ],
              "modification": "NEW",
              "nameOfClass": "FareStructureElement",
              "status": "DRAFT",
              "validityConditions": [
                {
                  "changed": "changed",
                  "created": "created",
                  "fromDate": "fromDate",
                  "id": "NSB:ValidBetween:2018",
                  "modification": "NEW",
                  "nameOfClass": "ValidBetween",
                  "status": "DRAFT",
                  "toDate": "toDate",
                  "version": "NSB:Version:V1"
                }
              ],
              "version": "NSB:Version:V1"
            },
            "id": "NSB:TemporalValidityParameter:OperatorNSB",
            "modification": "NEW",
            "nameOfClass": "TemporalValidityParameter",
            "status": "DRAFT",
            "validityCondition": {
              "changed": "changed",
              "created": "created",
              "fromDate": "fromDate",
              "id": "NSB:ValidBetween:2018",
              "modification": "NEW",
              "nameOfClass": "ValidBetween",
              "status": "DRAFT",
              "toDate": "toDate",
              "version": "NSB:Version:V1"
            },
            "validityConditionRef": {
              "nameOfClass": "nameOfClass",
              "ref": "ref",
              "version": "version"
            },
            "version": "NSB:Version:V1"
          }
        ],
        "typeOfAccessRightAssignment": {
          "changed": "changed",
          "compatibleWithVersionRef": "compatibleWithVersionRef",
          "created": "created",
          "derivedFromVersionRef": "derivedFromVersionRef",
          "description": [
            {
              "lang": "nob",
              "value": "value"
            }
          ],
          "fareFrameRef": {
            "nameOfClass": "nameOfClass",
            "ref": "ref",
            "version": "version"
          },
          "id": "ENT:TypeOfAccessRightAssignment:ActivationPolicyAssignment",
          "modification": "NEW",
          "name": [
            {
              "lang": "nob",
              "value": "value"
            }
          ],
          "nameOfClass": "TypeOfAccessRightAssignment",
          "status": "DRAFT",
          "version": "NSB:Version:V1"
        },
        "validableElementRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "validityParameterAssignmentType": "EQ",
        "validityParameterGroupingType": "AND",
        "validityParameterSetSelectionType": "ONE_OF_ANY_ONE_SET",
        "validityParameters": [
          {
            "authorityRef": "NSB:Authority:NSB",
            "changed": "changed",
            "compatibleWithVersionRef": "compatibleWithVersionRef",
            "created": "created",
            "derivedFromVersionRef": "derivedFromVersionRef",
            "distributionChannelRef": "ENT:DistributionChannel:App",
            "facilitySetRef": "facilitySetRef",
            "fareClasses": [
              "string"
            ],
            "fareFrameRef": {
              "nameOfClass": "nameOfClass",
              "ref": "ref",
              "version": "version"
            },
            "fareSectionRef": "fareSectionRef",
            "fareZoneRef": "KOL:FareZone:250",
            "genericParameterAssignmentRef": {
              "nameOfClass": "nameOfClass",
              "ref": "ref",
              "version": "version"
            },
            "groupOfLinesRef": "ENT:GroupOfLines:AllLines",
            "groupOfTariffZonesRef": "ENT:GroupOfTariffZones:AllZones",
            "id": "NSB:ScopingValidityParameter:OperatorNSB",
            "lineRef": "lineRef",
            "lineType": "EXPRESS",
            "modification": "NEW",
            "nameOfClass": "ScopingValidityParameter",
            "operatorRef": "operatorRef",
            "placeUse": "START_AT",
            "scheduledStopPointRef": "scheduledStopPointRef",
            "status": "DRAFT",
            "tariffZoneRef": "RUT:TariffZone:2S",
            "topographicPlaceRef": "topographicPlaceRef",
            "transportSubmode": "expressBus",
            "vehicleMode": "AIR",
            "version": "NSB:Version:V1"
          }
        ],
        "version": "NSB:Version:V2"
      }
    ],
    "accessRightsInProduct": [
      {
        "accessNumber": 0,
        "accessNumberIsLimited": true,
        "changed": "changed",
        "compatibleWithVersionRef": "compatibleWithVersionRef",
        "created": "created",
        "derivedFromVersionRef": "derivedFromVersionRef",
        "description": [
          {
            "lang": "nob",
            "value": "value"
          }
        ],
        "fareFrameRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "id": "NSB:AccessRightInProduct:Ordinary",
        "isFirstInSequence": true,
        "isLastInSequence": true,
        "limitedAccessNumber": 0,
        "maximumAccess": 0,
        "minimumAccess": 0,
        "modification": "NEW",
        "name": [
          {
            "lang": "nob",
            "value": "value"
          }
        ],
        "nameOfClass": "Refunding",
        "orderOfElement": 0,
        "preassignedFareProductRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "status": "DRAFT",
        "validableElementRef": {
          "nameOfClass": "nameOfClass",
          "ref": "ref",
          "version": "version"
        },
        "version": "NSB:Version:V1"
      }
    ],
    "activeComparisonOperatorVariant": "E",
    "changed": "changed",
    "chargingMoment": {
      "changed": "changed",
      "compatibleWithVersionRef": "compatibleWithVersionRef",
      "created": "created",
      "derivedFromVersionRef": "derivedFromVersionRef",
      "description": [
        {
          "lang": "nob",
          "value": "value"
        }
      ],
      "fareFrameRef": {
        "nameOfClass": "nameOfClass",
        "ref": "ref",
        "version": "version"
      },
      "id": "NSB:ChargingMoment:Prepaid",
      "modification": "NEW",
      "name": [
        {
          "lang": "nob",
          "value": "value"
        }
      ],
      "nameOfClass": "ChargingMoment",
      "status": "DRAFT",
      "version": "NSB:Version:V1"
    },
    "chargingMomentType": "BEFORE_TRAVEL",
    "compatibleWithVersionRef": "compatibleWithVersionRef",
    "conditionSummary": {
      "id": "NSB:ConditionSummary:1005TEN",
      "isExchangeable": true,
      "isRefundable": true
    },
    "created": "created",
    "derivedFromVersionRef": "derivedFromVersionRef",
    "description": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "fareFrameRef": {
      "nameOfClass": "nameOfClass",
      "ref": "ref",
      "version": "version"
    },
    "fareStructureType": "ZONE_TO_ZONE_FARE",
    "fareTableRefs": [
      {
        "nameOfClass": "nameOfClass",
        "ref": "ref",
        "version": "version"
      }
    ],
    "id": "RUT:PreassignedFareProduct:RuterSingleTicket",
    "limitingRuleRef": {
      "nameOfClass": "nameOfClass",
      "ref": "ref",
      "version": "version"
    },
    "modification": "NEW",
    "name": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "nameOfClass": "PreassignedFareProduct",
    "operatorRef": "RUT:Authority:RUT",
    "organisation": "organisation",
    "organisationId": "organisationId",
    "privateCode": "privateCode",
    "status": "DRAFT",
    "typeOfFareProduct": {
      "changed": "changed",
      "compatibleWithVersionRef": "compatibleWithVersionRef",
      "created": "created",
      "derivedFromVersionRef": "derivedFromVersionRef",
      "description": [
        {
          "lang": "nob",
          "value": "value"
        }
      ],
      "fareFrameRef": {
        "nameOfClass": "nameOfClass",
        "ref": "ref",
        "version": "version"
      },
      "id": "NSB:TypeOfFareProduct:Ordinary",
      "modification": "NEW",
      "name": [
        {
          "lang": "nob",
          "value": "value"
        }
      ],
      "nameOfClass": "TypeOfFareProduct",
      "status": "DRAFT",
      "version": "NSB:Version:V1"
    },
    "validityConditions": [
      {
        "changed": "changed",
        "created": "created",
        "fromDate": "fromDate",
        "id": "NSB:ValidBetween:2018",
        "modification": "NEW",
        "nameOfClass": "ValidBetween",
        "status": "DRAFT",
        "toDate": "toDate",
        "version": "NSB:Version:V1"
      }
    ],
    "version": "NSB:Version:V1"
  }
]

json

application/json

fare-frames fare-quota-factors

Did you find what you were looking for?

Build with Entur

Contribute

Terms & Policies

fare-products

Retrieves all fare-products, filtered by given parameter(s)

Retrieves all fare-products, filtered by given parameter(s) › query Parameters

Retrieves all fare-products, filtered by given parameter(s) › Headers

Retrieves all fare-products, filtered by given parameter(s) › Responses