fare-day-types

Server

Download schema

Retrieves all fare day types

GET

https://api.entur.io/products

/fare-day-types

Retrieves all fare day types › query Parameters

orgId

string · style: form · explode: true

fareFrameId

string · style: form · explode: true

minimizeDataLoad

boolean · style: form · explode: true

Retrieves all fare day types › Headers

ET-Client-Name

string

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> for companies, and <personal name>-<application> for individuals.

X-Correlation-Id

string

Correlation id

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 day types › Responses

Returns the info

FareDayType[]

The FareDayType describe during which the assignment applies

FareDayType

id

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

Id.

Example: NSB:FareDayType:2HoursValidPlus1

TextInLanguage[] · required

Name of fare day type

status

string · enum · readOnly · required

Status.

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

changed

string · readOnly · required

Changed datetime.

created

string · readOnly · required

Created datetime.

version

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

Version.

Example: NSB:Version:V1

TextInLanguage[] · required

Description of fare day type

nameOfClass

string · readOnly · required

Name of class.

Example: FareDayType

modification

string · enum · readOnly · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

dayLength

string

Day length. Represented as a string formatted according to ISO-8601

Example: PT04H

PropertyOfDay[]

Properties of day

earliestTime

string

Earliest time.

Example: 11:11:11

VersionOfObjectRef[]

Time band references.

durationAfterPropertiesOfDay

string

Duration after properties of day. Represented as a string formatted according to ISO-8601

Example: PT7H

durationBeforePropertiesOfDay

string

Duration before properties of day. Represented as a string formatted according to ISO-8601

Example: PT24H

GET/fare-day-types

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

Example Responses

[
  {
    "id": "NSB:FareDayType:2HoursValidPlus1",
    "name": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "status": "DRAFT",
    "changed": "changed",
    "created": "created",
    "version": "NSB:Version:V1",
    "dayLength": "PT04H",
    "properties": [
      {
        "name": "Monday",
        "dayOfYear": "01-25",
        "countryRef": "NO",
        "daysOfWeek": [
          "string"
        ],
        "description": "Days family discount is available",
        "monthOfYear": 0,
        "holidayTypes": [
          "string"
        ]
      }
    ],
    "description": [
      {
        "lang": "nob",
        "value": "value"
      }
    ],
    "nameOfClass": "FareDayType",
    "earliestTime": "11:11:11",
    "modification": "NEW",
    "timebandRefs": [
      {
        "ref": "ref",
        "version": "version",
        "nameOfClass": "nameOfClass"
      }
    ],
    "durationAfterPropertiesOfDay": "PT7H",
    "durationBeforePropertiesOfDay": "PT24H"
  }
]

json

application/json

Create a fare day Type

POST

https://api.entur.io/products

/fare-day-types

Create a fare day Type › Headers

ET-Client-Name

string

X-Correlation-Id

string

Correlation id

Create a fare day Type › Request Body

The FareDayType describe during which the assignment applies

FareDayType

id

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

Id.

Example: NSB:FareDayType:2HoursValidPlus1

TextInLanguage[] · required

Name of fare day type

status

string · enum · readOnly · required

Status.

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

changed

string · readOnly · required

Changed datetime.

created

string · readOnly · required

Created datetime.

version

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

Version.

Example: NSB:Version:V1

TextInLanguage[] · required

Description of fare day type

nameOfClass

string · readOnly · required

Name of class.

Example: FareDayType

modification

string · enum · readOnly · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

dayLength

string

Day length. Represented as a string formatted according to ISO-8601

Example: PT04H

PropertyOfDay[]

Properties of day

earliestTime

string

Earliest time.

Example: 11:11:11

VersionOfObjectRef[]

Time band references.

durationAfterPropertiesOfDay

string

Duration after properties of day. Represented as a string formatted according to ISO-8601

Example: PT7H

durationBeforePropertiesOfDay

string

Duration before properties of day. Represented as a string formatted according to ISO-8601

Example: PT24H

Create a fare day Type › Responses

Entity created successfully

No data returned

POST/fare-day-types

curl https://api.entur.io/products/fare-day-types \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "NSB:FareDayType:2HoursValidPlus1",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "status": "DRAFT",
  "changed": "changed",
  "created": "created",
  "version": "NSB:Version:V1",
  "dayLength": "PT04H",
  "properties": [
    {
      "name": "Monday",
      "dayOfYear": "01-25",
      "countryRef": "NO",
      "daysOfWeek": [
        "string"
      ],
      "description": "Days family discount is available",
      "monthOfYear": 0,
      "holidayTypes": [
        "string"
      ]
    }
  ],
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "nameOfClass": "FareDayType",
  "earliestTime": "11:11:11",
  "modification": "NEW",
  "timebandRefs": [
    {
      "ref": "ref",
      "version": "version",
      "nameOfClass": "nameOfClass"
    }
  ],
  "durationAfterPropertiesOfDay": "PT7H",
  "durationBeforePropertiesOfDay": "PT24H"
}'

Example Request Body

{
  "id": "NSB:FareDayType:2HoursValidPlus1",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "status": "DRAFT",
  "changed": "changed",
  "created": "created",
  "version": "NSB:Version:V1",
  "dayLength": "PT04H",
  "properties": [
    {
      "name": "Monday",
      "dayOfYear": "01-25",
      "countryRef": "NO",
      "daysOfWeek": [
        "string"
      ],
      "description": "Days family discount is available",
      "monthOfYear": 0,
      "holidayTypes": [
        "string"
      ]
    }
  ],
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "nameOfClass": "FareDayType",
  "earliestTime": "11:11:11",
  "modification": "NEW",
  "timebandRefs": [
    {
      "ref": "ref",
      "version": "version",
      "nameOfClass": "nameOfClass"
    }
  ],
  "durationAfterPropertiesOfDay": "PT7H",
  "durationBeforePropertiesOfDay": "PT24H"
}

json

Example Responses

No example specified for this content type

Retrieves fare day type for id and version

GET

https://api.entur.io/products

/fare-day-types/{id}/{version}

Retrieves fare day type for id and version › path Parameters

id

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

The id to identify a fare day type

version

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

The id for the version of the fare day type

Retrieves fare day type for id and version › Headers

ET-Client-Name

string

X-Correlation-Id

string

Correlation id

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 fare day type for id and version › Responses

Returns the info

The FareDayType describe during which the assignment applies

FareDayType

id

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

Id.

Example: NSB:FareDayType:2HoursValidPlus1

TextInLanguage[] · required

Name of fare day type

status

string · enum · readOnly · required

Status.

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

changed

string · readOnly · required

Changed datetime.

created

string · readOnly · required

Created datetime.

version

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

Version.

Example: NSB:Version:V1

TextInLanguage[] · required

Description of fare day type

nameOfClass

string · readOnly · required

Name of class.

Example: FareDayType

modification

string · enum · readOnly · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

dayLength

string

Day length. Represented as a string formatted according to ISO-8601

Example: PT04H

PropertyOfDay[]

Properties of day

earliestTime

string

Earliest time.

Example: 11:11:11

VersionOfObjectRef[]

Time band references.

durationAfterPropertiesOfDay

string

Duration after properties of day. Represented as a string formatted according to ISO-8601

Example: PT7H

durationBeforePropertiesOfDay

string

Duration before properties of day. Represented as a string formatted according to ISO-8601

Example: PT24H

GET/fare-day-types/{id}/{version}

curl https://api.entur.io/products/fare-day-types/:id/:version

Example Responses

{
  "id": "NSB:FareDayType:2HoursValidPlus1",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "status": "DRAFT",
  "changed": "changed",
  "created": "created",
  "version": "NSB:Version:V1",
  "dayLength": "PT04H",
  "properties": [
    {
      "name": "Monday",
      "dayOfYear": "01-25",
      "countryRef": "NO",
      "daysOfWeek": [
        "string"
      ],
      "description": "Days family discount is available",
      "monthOfYear": 0,
      "holidayTypes": [
        "string"
      ]
    }
  ],
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "nameOfClass": "FareDayType",
  "earliestTime": "11:11:11",
  "modification": "NEW",
  "timebandRefs": [
    {
      "ref": "ref",
      "version": "version",
      "nameOfClass": "nameOfClass"
    }
  ],
  "durationAfterPropertiesOfDay": "PT7H",
  "durationBeforePropertiesOfDay": "PT24H"
}

json

application/json

Updates an existing fare day type

PUT

https://api.entur.io/products

/fare-day-types/{id}/{version}

Updates an existing fare day type › path Parameters

id

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

The id to identify a fare day type

version

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

The id for the version of the fare day type

Updates an existing fare day type › Headers

ET-Client-Name

string

X-Correlation-Id

string

Correlation id

Updates an existing fare day type › Request Body

The FareDayType describe during which the assignment applies

FareDayType

id

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

Id.

Example: NSB:FareDayType:2HoursValidPlus1

TextInLanguage[] · required

Name of fare day type

status

string · enum · readOnly · required

Status.

Enum values:

DRAFT

PROPOSED

VERSIONED

DEPRECATED

Example: DRAFT

changed

string · readOnly · required

Changed datetime.

created

string · readOnly · required

Created datetime.

version

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

Version.

Example: NSB:Version:V1

TextInLanguage[] · required

Description of fare day type

nameOfClass

string · readOnly · required

Name of class.

Example: FareDayType

modification

string · enum · readOnly · required

Modification status.

Enum values:

NEW

REVISE

DELETE

Example: NEW

dayLength

string

Day length. Represented as a string formatted according to ISO-8601

Example: PT04H

PropertyOfDay[]

Properties of day

earliestTime

string

Earliest time.

Example: 11:11:11

VersionOfObjectRef[]

Time band references.

durationAfterPropertiesOfDay

string

Duration after properties of day. Represented as a string formatted according to ISO-8601

Example: PT7H

durationBeforePropertiesOfDay

string

Duration before properties of day. Represented as a string formatted according to ISO-8601

Example: PT24H

Updates an existing fare day type › Responses

Entity updated successfully

No data returned

PUT/fare-day-types/{id}/{version}

curl https://api.entur.io/products/fare-day-types/:id/:version \
  --request PUT \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "NSB:FareDayType:2HoursValidPlus1",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "status": "DRAFT",
  "changed": "changed",
  "created": "created",
  "version": "NSB:Version:V1",
  "dayLength": "PT04H",
  "properties": [
    {
      "name": "Monday",
      "dayOfYear": "01-25",
      "countryRef": "NO",
      "daysOfWeek": [
        "string"
      ],
      "description": "Days family discount is available",
      "monthOfYear": 0,
      "holidayTypes": [
        "string"
      ]
    }
  ],
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "nameOfClass": "FareDayType",
  "earliestTime": "11:11:11",
  "modification": "NEW",
  "timebandRefs": [
    {
      "ref": "ref",
      "version": "version",
      "nameOfClass": "nameOfClass"
    }
  ],
  "durationAfterPropertiesOfDay": "PT7H",
  "durationBeforePropertiesOfDay": "PT24H"
}'

Example Request Body

{
  "id": "NSB:FareDayType:2HoursValidPlus1",
  "name": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "status": "DRAFT",
  "changed": "changed",
  "created": "created",
  "version": "NSB:Version:V1",
  "dayLength": "PT04H",
  "properties": [
    {
      "name": "Monday",
      "dayOfYear": "01-25",
      "countryRef": "NO",
      "daysOfWeek": [
        "string"
      ],
      "description": "Days family discount is available",
      "monthOfYear": 0,
      "holidayTypes": [
        "string"
      ]
    }
  ],
  "description": [
    {
      "lang": "nob",
      "value": "value"
    }
  ],
  "nameOfClass": "FareDayType",
  "earliestTime": "11:11:11",
  "modification": "NEW",
  "timebandRefs": [
    {
      "ref": "ref",
      "version": "version",
      "nameOfClass": "nameOfClass"
    }
  ],
  "durationAfterPropertiesOfDay": "PT7H",
  "durationBeforePropertiesOfDay": "PT24H"
}

json

Example Responses

No example specified for this content type

Deletes an day type given by id and version

DELETE

https://api.entur.io/products

/fare-day-types/{id}/{version}

Deletes an day type given by id and version › path Parameters

id

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

The id to identify a fare day type

version

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

The id for the version of the fare day type

Deletes an day type given by id and version › Headers

ET-Client-Name

string

X-Correlation-Id

string

Correlation id

Deletes an day type given by id and version › Responses

The resource was deleted

BoxedUnit

user-profiles interchangings

Build with Entur

Contribute

Terms & Policies

fare-day-types

Retrieves all fare day types

Retrieves all fare day types › query Parameters

Retrieves all fare day types › Headers

Retrieves all fare day types › Responses

Create a fare day Type

Create a fare day Type › Headers

Create a fare day Type › Request Body

Create a fare day Type › Responses

Retrieves fare day type for id and version

Retrieves fare day type for id and version › path Parameters

Retrieves fare day type for id and version › Headers

Retrieves fare day type for id and version › Responses

Updates an existing fare day type

Updates an existing fare day type › path Parameters

Updates an existing fare day type › Headers

Updates an existing fare day type › Request Body

Updates an existing fare day type › Responses

Deletes an day type given by id and version

Deletes an day type given by id and version › path Parameters

Deletes an day type given by id and version › Headers

Deletes an day type given by id and version › Responses