Entur Companies API
Administer companies and workplaces within the personnel ticket system
Administer companies and workplaces within the personnel ticket system
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-companies-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: Personnel tickets Companies API
description: Personnel tickets are a Norwegian railway discount scheme providing reduced fares for employees, pensioners, and eligible family members in participating companies.
termsOfService: http://entur.org
contact:
name: Entur Team Personalisering
email: team.personalisering@entur.org
version: 2026.08.0
servers:
- url: https://api.entur.io
security:
- jwt: []
tags:
- name: Companies
description: Administer companies and workplaces within the personnel ticket system
paths:
/personnelticket/v2/companies:
parameters:
- $ref: '#/components/parameters/ET-Client-Name'
- $ref: '#/components/parameters/X-Correlation-Id'
get:
tags:
- Companies
summary: Get companies by params
operationId: findCompanies
parameters:
- name: employeeNoPrefix
in: query
required: false
style: form
explode: true
schema:
type: string
- name: name
in: query
required: false
style: form
explode: true
schema:
type: string
- name: includeDeleted
in: query
required: false
style: form
explode: true
schema:
type: boolean
- name: page
in: query
required: false
style: form
explode: true
schema:
type: integer
format: int32
- name: perPage
in: query
required: false
style: form
explode: true
schema:
type: integer
format: int32
responses:
'200':
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/PageCompanyResponse'
'401':
$ref: '#/components/responses/Error401'
'403':
$ref: '#/components/responses/Error403'
'404':
$ref: '#/components/responses/Error404'
'500':
$ref: '#/components/responses/Error500'
x-entur-permissions:
value:
any:
- Personalbillett-Administrasjon:les
- Personalbillett-Administrasjon-Selskap:les
components:
schemas:
ErrorResponse:
required:
- correlationId
- error
- message
- path
- status
- timestamp
type: object
properties:
timestamp:
type: string
description: When the error occurred.
format: date-time
examples:
- '2007-12-03T10:15:30+01:00'
status:
type: integer
description: The http status code.
format: int32
examples:
- 400
errorCode:
type: string
description: Application specific error code
examples:
- '1033'
error:
type: string
description: The http status reason.
examples:
- Bad request
path:
type: string
description: The request URI.
examples:
- /loyaltyPrograms
message:
type: string
description: The main error message.
examples:
- Validation failed for ...
correlationId:
type: string
description: The unique correlation id for the request.
examples:
- b5d4960d-7ab2-43d6-a8f3-113da042a288
errors:
type: array
description: Optional list of error specifications.
items:
$ref: '#/components/schemas/ErrorSpecification'
description: Response object for errors occurring in the customers API
PageCompanyResponse:
required:
- items
- totalItems
- totalPages
type: object
properties:
items:
type: array
description: All items for this page
items:
$ref: '#/components/schemas/CompanyResponse'
totalItems:
type: integer
description: Total items which could be returned
format: int64
examples:
- 1
totalPages:
type: integer
description: Total number of pages
format: int64
examples:
- 1
description: Paged content
ErrorSpecification:
required:
- defaultMessage
- field
type: object
properties:
field:
type: string
description: The field of the associated object in the request related to the error.
defaultMessage:
type: string
description: The message explaining why the error occurred.
rejectedValues:
type: object
description: A list of rejected values.
description: Optional list of error specifications.
CompanyResponse:
required:
- addressLine
- allowETickets
- allowLocalEmployees
- companyId
- employeeNoPrefix
- isDeleted
- name
- postalCode
- reportSeparator
type: object
properties:
companyId:
type: integer
description: The company ID
format: int64
name:
type: string
description: The company name
addressLine:
type: string
description: The company postal address
postalCode:
type: string
description: The company postal code
employeeNoPrefix:
type: string
description: A prefix to be prepended to all employee numbers connected to this company
allowLocalEmployees:
type: boolean
description: Whether local employees are allowed
allowETickets:
type: boolean
description: Whether the company allows the usage of e-tickets for its personnel tickets
isDeleted:
type: boolean
description: Whether the company is deleted
reportSeparator:
type: string
description: 'Which character to separate elements within tax report: '',''(default) or '';'''
deleted:
type: boolean
writeOnly: true
description: Companies are where employees are hired
responses:
Error401:
description: Unauthorized
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Error404:
description: Not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Error403:
description: Forbidden
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
Error500:
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
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