Entur Fare Day Types API
The fare-day-types API from Entur — 3 operation(s) for fare-day-types.
The fare-day-types API from Entur — 3 operation(s) for fare-day-types.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/entur:entur-fare-day-types-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Products Fare Day Types API
description: This API provides services to read and maintain products and fare data for public transport in Norway.
version: 2026.10.0
servers:
- url: https://api.entur.io/products
description: Production environment
- url: https://api.staging.entur.io/products
description: Staging environment
- url: https://api.dev.entur.io/products
description: Development environment
security:
- jwt: []
tags:
- name: fare-day-types
paths:
/fare-day-types:
parameters:
- $ref: '#/components/parameters/ET-Client-Name'
- $ref: '#/components/parameters/X-Correlation-Id'
get:
tags:
- fare-day-types
summary: Retrieves all fare day types
operationId: fare-day-types_getAll
parameters:
- name: orgId
in: query
required: false
style: form
explode: true
schema:
type: string
- name: fareFrameId
in: query
required: false
style: form
explode: true
schema:
type: string
- name: minimizeDataLoad
in: query
required: false
style: form
explode: true
schema:
type: boolean
- name: validOnDate
in: query
description: Return only the versions valid on the given date (ISO-8601).
required: false
style: form
explode: true
schema:
type: string
format: date-time
- name: If-None-Match
in: header
description: 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.
required: false
style: simple
explode: false
schema:
type: string
responses:
'200':
description: Returns the info
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/FareDayType'
'304':
description: Not Modified
'400':
description: Bad Request
content:
application/problem+json:
schema:
type: string
'401':
description: Unauthorized
content:
application/problem+json:
schema:
type: string
'403':
description: Authorization failed
content:
application/problem+json:
schema:
type: string
'404':
description: Not Found
content:
application/problem+json:
schema:
type: string
'500':
description: Internal server error
content:
application/problem+json:
schema:
type: string
security:
- basic_auth: []
x-entur-permissions:
value: product-api-access:les
post:
tags:
- fare-day-types
summary: Create a fare day Type
operationId: fare-day-types_create
parameters: []
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FareDayType'
required: true
responses:
'204':
description: Entity created successfully
'400':
description: Validation errors
content:
application/problem+json:
schema:
type: string
'401':
description: Unauthorized
content:
application/problem+json:
schema:
type: string
'403':
description: Forbidden
content:
application/problem+json:
schema:
type: string
'404':
description: Not Found
content:
application/problem+json:
schema:
type: string
'409':
description: Already registered
content:
application/problem+json:
schema:
type: string
'500':
description: Internal server error
content:
application/problem+json:
schema:
type: string
security:
- basic_auth: []
x-entur-permissions:
value: product-api-access:endre
/fare-day-types/{id}:
parameters:
- $ref: '#/components/parameters/ET-Client-Name'
- $ref: '#/components/parameters/X-Correlation-Id'
get:
tags:
- fare-day-types
summary: Retrieves the fare day type valid on a given date
description: Optional validOnDate query parameter (defaults to now). In prod returns the VERSIONED element; in staging/dev PROPOSED is preferred over VERSIONED.
operationId: fare-day-types_getByIdAndValidOnDate
parameters:
- name: id
in: path
description: The id to identify a fare day type
required: true
style: simple
explode: false
schema:
type: string
- name: validOnDate
in: query
description: Return the version valid on the given date (ISO-8601).
required: false
style: form
explode: true
schema:
type: string
format: date-time
- name: If-None-Match
in: header
description: 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.
required: false
style: simple
explode: false
schema:
type: string
responses:
'200':
description: Returns the info
content:
application/json:
schema:
$ref: '#/components/schemas/FareDayType'
'304':
description: Not Modified
'400':
description: Bad Request
content:
application/problem+json:
schema:
type: string
'401':
description: Unauthorized
content:
application/problem+json:
schema:
type: string
'403':
description: Forbidden
content:
application/problem+json:
schema:
type: string
'404':
description: Resource not found
content:
application/problem+json:
schema:
type: string
'500':
description: Internal server error
content:
application/problem+json:
schema:
type: string
security:
- basic_auth: []
x-entur-permissions:
value: product-api-access:les
/fare-day-types/{id}/{version}:
parameters:
- $ref: '#/components/parameters/ET-Client-Name'
- $ref: '#/components/parameters/X-Correlation-Id'
get:
tags:
- fare-day-types
summary: Retrieves fare day type for id and version
operationId: fare-day-types_getById
parameters:
- name: id
in: path
description: The id to identify a fare day type
required: true
style: simple
explode: false
schema:
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
- name: version
in: path
description: The id for the version of the fare day type
required: true
style: simple
explode: false
schema:
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
- name: If-None-Match
in: header
description: 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.
required: false
style: simple
explode: false
schema:
type: string
responses:
'200':
description: Returns the info
content:
application/json:
schema:
$ref: '#/components/schemas/FareDayType'
'304':
description: Not Modified
'400':
description: Bad Request
content:
application/problem+json:
schema:
type: string
'401':
description: Unauthorized
content:
application/problem+json:
schema:
type: string
'403':
description: Authorization failed
content:
application/problem+json:
schema:
type: string
'404':
description: Resource not found
content:
application/problem+json:
schema:
type: string
'500':
description: Internal server error
content:
application/problem+json:
schema:
type: string
security:
- basic_auth: []
x-entur-permissions:
value: product-api-access:les
put:
tags:
- fare-day-types
summary: Updates an existing fare day type
operationId: fare-day-types_update
parameters:
- name: id
in: path
description: The id to identify a fare day type
required: true
style: simple
explode: false
schema:
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
- name: version
in: path
description: The id for the version of the fare day type
required: true
style: simple
explode: false
schema:
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FareDayType'
required: true
responses:
'204':
description: Entity updated successfully
'400':
description: Validation errors
content:
application/problem+json:
schema:
type: string
'401':
description: Missing Authorization
content:
application/problem+json:
schema:
type: string
'403':
description: Authorization failed
content:
application/problem+json:
schema:
type: string
'404':
description: Resource not found
content:
application/problem+json:
schema:
type: string
'409':
description: Conflict
content:
application/problem+json:
schema:
type: string
'500':
description: Internal server error
content:
application/problem+json:
schema:
type: string
security:
- basic_auth: []
x-entur-permissions:
value: product-api-access:endre
delete:
tags:
- fare-day-types
summary: Deletes an day type given by id and version
operationId: fare-day-types_deleteById
parameters:
- name: id
in: path
description: The id to identify a fare day type
required: true
style: simple
explode: false
schema:
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
- name: version
in: path
description: The id for the version of the fare day type
required: true
style: simple
explode: false
schema:
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
responses:
'200':
description: The resource was deleted
content:
application/json:
schema:
$ref: '#/components/schemas/BoxedUnit'
'400':
description: Bad Request
content:
application/problem+json:
schema:
type: string
'401':
description: Unauthorized
content:
application/problem+json:
schema:
type: string
'403':
description: Forbidden
content:
application/problem+json:
schema:
type: string
'404':
description: Resource not found
content:
application/problem+json:
schema:
type: string
'409':
description: Conflict
content:
application/problem+json:
schema:
type: string
'500':
description: Internal server error
content:
application/problem+json:
schema:
type: string
security:
- basic_auth: []
x-entur-permissions:
value: product-api-access:endre
components:
schemas:
FareDayType:
required:
- changed
- created
- description
- id
- modification
- name
- nameOfClass
- status
- version
type: object
properties:
changed:
type: string
description: Changed datetime.
readOnly: true
created:
type: string
description: Created datetime.
readOnly: true
dayLength:
type: string
description: Day length. Represented as a string formatted according to ISO-8601
examples:
- PT04H
description:
type: array
description: Description of fare day type
items:
$ref: '#/components/schemas/TextInLanguage'
durationAfterPropertiesOfDay:
type: string
description: Duration after properties of day. Represented as a string formatted according to ISO-8601
examples:
- PT7H
durationBeforePropertiesOfDay:
type: string
description: Duration before properties of day. Represented as a string formatted according to ISO-8601
examples:
- PT24H
earliestTime:
type: string
description: Earliest time.
examples:
- '11:11:11'
id:
minLength: 1
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
description: Id.
examples:
- NSB:FareDayType:2HoursValidPlus1
modification:
type: string
description: Modification status.
readOnly: true
enum:
- NEW
- REVISE
- DELETE
examples:
- NEW
name:
type: array
description: Name of fare day type
items:
$ref: '#/components/schemas/TextInLanguage'
nameOfClass:
type: string
description: Name of class.
readOnly: true
examples:
- FareDayType
properties:
type: array
description: Properties of day
items:
$ref: '#/components/schemas/PropertyOfDay'
status:
type: string
description: Status.
readOnly: true
enum:
- DRAFT
- PROPOSED
- VERSIONED
- DEPRECATED
examples:
- DRAFT
timebandRefs:
type: array
description: Time band references.
items:
$ref: '#/components/schemas/VersionOfObjectRef'
version:
minLength: 1
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
description: Version.
examples:
- NSB:Version:V1
description: The FareDayType describe during which the assignment applies
VersionOfObjectRef:
required:
- nameOfClass
- ref
- version
type: object
properties:
nameOfClass:
minLength: 1
type: string
description: Name of class.
ref:
minLength: 1
pattern: ^([A-Z]{3}):([A-Za-z]*):([0-9A-Za-z_\-]*)$
type: string
description: The netex id reference to the object.
version:
type: string
description: Version.
description: Fare frame ref.
PropertyOfDay:
required:
- countryRef
- name
type: object
properties:
countryRef:
type: string
description: Reference to country for holiday. ISO 3166-1
readOnly: true
examples:
- 'NO'
dayOfYear:
type: string
description: Day of year
format: '##-##'
examples:
- 01-25
daysOfWeek:
type: array
description: Days of week
items:
type: string
description:
type: string
description: Description of the property of day
examples:
- Days family discount is available
holidayTypes:
type: array
description: Holiday types
items:
type: string
monthOfYear:
type: integer
description: Month of year
format: int32
enum:
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
name:
type: string
description: Name of property of day
examples:
- Monday
description: The DayType describe during which the assignment applies
TextInLanguage:
required:
- lang
- value
type: object
properties:
lang:
minLength: 1
type: string
description: Language code.
examples:
- nob
value:
minLength: 1
type: string
description: The text.
description: Text in a specific language.
BoxedUnit:
type: object
parameters:
ET-Client-Name:
name: ET-Client-Name
in: header
description: '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>`.'
required: false
style: simple
explode: false
schema:
type: string
X-Correlation-Id:
name: X-Correlation-Id
in: header
description: Correlation id
required: false
style: simple
explode: false
schema:
type: string
securitySchemes:
jwt:
type: http
scheme: bearer
bearerFormat: JWT