tariffs

Server

Download schema

Create a tariff

POST

https://api.entur.io/products

/tariffs

Create a tariff › 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 tariff › Request Body

TariffInsert

VersionOfObjectRef · required

Fare frame ref.

id

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

Example: NSB:Tariff:Ordinary

TextInLanguage[] · required

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

VersionOfObjectRef · required

Fare frame ref.

version

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

Tariff version.

Example: NSB:Version:V1

derivedFromVersionRef

string

Derived from version.

TextInLanguage[]

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

returnFareTwiceSingle

boolean

returnFareTwiceSingle

tariffBasis

string · enum

TariffBasis.

Enum values:

NEW

REVISE

DELETE

Example: NEW

Create a tariff › Responses

Entity created successfully

No data returned

POST/tariffs

curl https://api.entur.io/products/tariffs \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "derivedFromVersionRef": "derivedFromVersionRef",
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "fareFrameRef": {
    "nameOfClass": "nameOfClass",
    "ref": "ref",
    "version": "version"
  },
  "id": "NSB:Tariff:Ordinary",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "returnFareTwiceSingle": true,
  "tariffBasis": "NEW",
  "validBetweenRef": {
    "nameOfClass": "nameOfClass",
    "ref": "ref",
    "version": "version"
  },
  "version": "NSB:Version:V1"
}'

Example Request Body

{
  "derivedFromVersionRef": "derivedFromVersionRef",
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "fareFrameRef": {
    "nameOfClass": "nameOfClass",
    "ref": "ref",
    "version": "version"
  },
  "id": "NSB:Tariff:Ordinary",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "returnFareTwiceSingle": true,
  "tariffBasis": "NEW",
  "validBetweenRef": {
    "nameOfClass": "nameOfClass",
    "ref": "ref",
    "version": "version"
  },
  "version": "NSB:Version:V1"
}

json

Example Responses

No example specified for this content type

Retrives a tariff by id

GET

https://api.entur.io/products

/tariffs/{id}/{version}

Retrives a tariff by id › path Parameters

id

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

The unique id to identify a tariff

version

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

The id for the version of the tariff

Retrives a tariff by id › Headers

ET-Client-Name

string · style: simple

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.

Retrives a tariff by id › Responses

Returns the info

Tariff[]

A tariff

Tariff

changed

string · date-time · required

Changed datetime.

created

string · date-time · required

Created datetime.

VersionOfObjectRef · required

Fare frame ref.

id

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

Id.

Example: NSB:Tariff:Ordinary

modification

string · enum · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

nameOfClass

string · required

Name of class.

Example: Tariff

status

string · enum · required

Status

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

version

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

Tariffs version.

Example: NSB:Version:V1

compatibleWithVersionRef

string

Compatible with version.

derivedFromVersionRef

string

Derived from version.

TextInLanguage[]

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

TextInLanguage[]

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

organisationId

string

Organisation related to the userProfile

returnFareTwiceSingle

boolean

returnFareTwiceSingle

tariffBasis

string · enum

TariffBasis.

Enum values:

NEW

REVISE

DELETE

Example: NEW

VersionOfObjectRef

Fare frame ref.

GET/tariffs/{id}/{version}

curl https://api.entur.io/products/tariffs/:id/:version

Example Responses

[
  {
    "changed": "2024-08-25T15:00:00Z",
    "compatibleWithVersionRef": "compatibleWithVersionRef",
    "created": "2024-08-25T15:00:00Z",
    "derivedFromVersionRef": "derivedFromVersionRef",
    "description": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "fareFrameRef": {
      "nameOfClass": "nameOfClass",
      "ref": "ref",
      "version": "version"
    },
    "id": "NSB:Tariff:Ordinary",
    "modification": "NEW",
    "name": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "nameOfClass": "Tariff",
    "organisationId": "organisationId",
    "returnFareTwiceSingle": true,
    "status": "DRAFT",
    "tariffBasis": "NEW",
    "validBetweenRef": {
      "nameOfClass": "nameOfClass",
      "ref": "ref",
      "version": "version"
    },
    "version": "NSB:Version:V1"
  }
]

json

application/json

Retrives a tariff by id

GET

https://api.entur.io/products

/v1/tariffs/{id}

Retrives a tariff by id › path Parameters

id

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

The unique id to identify a tariff

Retrives a tariff by id › query Parameters

startDate

string · style: form · explode: true

endDate

string · style: form · explode: true

status

string · style: form · explode: true

The version status of the tariff

fromDate

string · style: form · explode: true

The from date of the tariffs version

toDate

string · style: form · explode: true

The to date of the tariffs version

Retrives a tariff by id › Headers

ET-Client-Name

string · style: simple

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.

Retrives a tariff by id › Responses

Returns the info

Tariff[]

A tariff

Tariff

changed

string · date-time · required

Changed datetime.

created

string · date-time · required

Created datetime.

VersionOfObjectRef · required

Fare frame ref.

id

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

Id.

Example: NSB:Tariff:Ordinary

modification

string · enum · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

nameOfClass

string · required

Name of class.

Example: Tariff

status

string · enum · required

Status

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

version

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

Tariffs version.

Example: NSB:Version:V1

compatibleWithVersionRef

string

Compatible with version.

derivedFromVersionRef

string

Derived from version.

TextInLanguage[]

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

TextInLanguage[]

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

organisationId

string

Organisation related to the userProfile

returnFareTwiceSingle

boolean

returnFareTwiceSingle

tariffBasis

string · enum

TariffBasis.

Enum values:

NEW

REVISE

DELETE

Example: NEW

VersionOfObjectRef

Fare frame ref.

GET/v1/tariffs/{id}

curl https://api.entur.io/products/v1/tariffs/:id

Example Responses

[
  {
    "changed": "2024-08-25T15:00:00Z",
    "compatibleWithVersionRef": "compatibleWithVersionRef",
    "created": "2024-08-25T15:00:00Z",
    "derivedFromVersionRef": "derivedFromVersionRef",
    "description": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "fareFrameRef": {
      "nameOfClass": "nameOfClass",
      "ref": "ref",
      "version": "version"
    },
    "id": "NSB:Tariff:Ordinary",
    "modification": "NEW",
    "name": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "nameOfClass": "Tariff",
    "organisationId": "organisationId",
    "returnFareTwiceSingle": true,
    "status": "DRAFT",
    "tariffBasis": "NEW",
    "validBetweenRef": {
      "nameOfClass": "nameOfClass",
      "ref": "ref",
      "version": "version"
    },
    "version": "NSB:Version:V1"
  }
]

json

application/json

service-facility-sets text-in-language

Did you find what you were looking for?

Build with Entur

Contribute

Terms & Policies

tariffs

Create a tariff

Create a tariff › Headers

Create a tariff › Request Body

Create a tariff › Responses

Retrives a tariff by id

Retrives a tariff by id › path Parameters

Retrives a tariff by id › Headers

Retrives a tariff by id › Responses

Retrives a tariff by id

Retrives a tariff by id › path Parameters

Retrives a tariff by id › query Parameters

Retrives a tariff by id › Headers

Retrives a tariff by id › Responses