openapi: 3.2.0
info:
  title: Entur Netex API
  version: 2026.08.0
  contact:
    name: Team Avstand og Nettverk
  description: 'Operations tagged Netex across 2 of this provider''s published API definitions: entur-prdudisapi-openapi.json, entur-prdudisapi-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.entur.io/distance
security:
- enturOpen: []
tags:
- name: Netex
paths:
  /netex/neighbour-distances:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Netex
      summary: Export neighbour distances as NeTEx
      description: Returns all Neighbour Distances as a NeTEx export
      operationId: exportDistancesAsNetex
      parameters:
      - name: organisationId
        in: query
        description: The internal ID of the organisation that owns the distances
        required: true
        style: form
        explode: true
        schema:
          type: integer
          format: int64
      - name: time
        in: query
        description: The time at which the distances are active to export
        required: false
        style: form
        explode: true
        schema:
          type: string
          format: date-time
      responses:
        '200':
          description: OK
          content:
            application/xml:
              examples:
                default:
                  value: Swagger can't support showing the XML sample, see https://github.com/OAI/OpenAPI-Specification/issues/630
        '400':
          description: Validation Error
          content:
            application/problem+xml:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                  errors:
                    type: array
                    items:
                      type: string
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  errors:
                  - Detail on first error
                  - Detail on second error
                  detail: Human readable error
        '401':
          description: Not Authorized
          content:
            application/problem+xml:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '403':
          description: Forbidden
          content:
            application/problem+xml:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '404':
          description: Resource Not Found
          content:
            application/problem+xml:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '500':
          description: Internal Error
          content:
            application/problem+xml:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
      security:
      - enturOpen: []
    servers:
    - url: https://api.entur.io/distance
  /netex/groups-of-tariff-zones:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Netex
      summary: Export group of tariff zones by authority ref as NeTEx
      description: Redirects to the GCS bucket URL for groups of tariff zones for an organisation as a NeTEx export
      operationId: exportGroupsOfTariffZonesAsNetexFromAuthRef
      parameters:
      - name: authorityRef
        in: query
        description: The authority reference of the organisation who owns the zones. Used as a replacement for internal organisation ID.
        required: false
        style: form
        explode: true
        schema:
          type: string
      - name: time
        in: query
        description: The time at which the zones are active to export
        required: false
        style: form
        explode: true
        schema:
          type: string
          format: date-time
      responses:
        '302':
          description: Redirects to a GCS bucket URL containing the NeTEx XML export of fare zones for the given authority
          headers:
            Location:
              description: The GCS bucket URL where the NeTEx XML file can be downloaded
              required: true
              style: simple
              explode: false
              schema:
                type: string
                format: uri
                examples:
                - https://storage.googleapis.com/bucket/fare-zones/export.xml
        '400':
          description: Validation Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                  errors:
                    type: array
                    items:
                      type: string
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  errors:
                  - Detail on first error
                  - Detail on second error
                  detail: Human readable error
        '401':
          description: Not Authorized
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '404':
          description: Resource Not Found
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '500':
          description: Internal Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
      security:
      - enturOpen: []
    servers:
    - url: https://api.entur.io/distance
  /netex/fare-zones:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Netex
      summary: Export fare zones as NeTEx
      description: Redirects to the GCS bucket URL for all Fare Zones for an organisation as a NeTEx export. If no organisation is provided, returns all Fare Zones across all organisations. If no time is provided, returns the latest Fare Zones. If time is provided, returns the Fare Zones valid at that time.
      operationId: exportZonesAsNetex
      parameters:
      - name: organisationId
        in: query
        description: The internal ID of the organisation that owns the fare zones
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int64
      - name: time
        in: query
        description: The time at which the zones are active to export
        required: false
        style: form
        explode: true
        schema:
          type: string
          format: date-time
      responses:
        '302':
          description: Redirects to a GCS bucket URL containing the NeTEx XML export of fare zones
          headers:
            Location:
              description: The GCS bucket URL where the NeTEx XML file can be downloaded
              required: true
              style: simple
              explode: false
              schema:
                type: string
                format: uri
                examples:
                - https://storage.googleapis.com/bucket/fare-zones/export.xml
        '400':
          description: Validation Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                  errors:
                    type: array
                    items:
                      type: string
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  errors:
                  - Detail on first error
                  - Detail on second error
                  detail: Human readable error
        '401':
          description: Not Authorized
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '404':
          description: Resource Not Found
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '500':
          description: Internal Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
      security:
      - enturOpen: []
    servers:
    - url: https://api.entur.io/distance
  /netex/fare-zones/{netexId}:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Netex
      summary: Export a single fare zone as NeTEx
      description: Redirects to the GCS bucket URL for all versions of a specific Fare Zone as a NeTEx export
      operationId: exportZoneAsNetex
      parameters:
      - name: netexId
        in: path
        description: Netex ID of zone to export
        required: true
        style: simple
        explode: false
        schema:
          type: string
      responses:
        '302':
          description: Redirects to a GCS bucket URL containing the NeTEx XML export of the specified fare zone
          headers:
            Location:
              description: The GCS bucket URL where the NeTEx XML file can be downloaded
              required: true
              style: simple
              explode: false
              schema:
                type: string
                format: uri
                examples:
                - https://storage.googleapis.com/bucket/fare-zones/export.xml
        '400':
          description: Validation Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                  errors:
                    type: array
                    items:
                      type: string
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  errors:
                  - Detail on first error
                  - Detail on second error
                  detail: Human readable error
        '401':
          description: Not Authorized
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '404':
          description: Resource Not Found
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '500':
          description: Internal Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
      security:
      - enturOpen: []
    servers:
    - url: https://api.entur.io/distance
  /netex/fare-zones/authority-ref:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Netex
      summary: Export fare zones by authority ref as NeTEx
      description: Redirects to the GCS bucket URL for all Fare Zones for an organisation as a NeTEx export
      operationId: exportZonesAsNetexFromAuthRef
      parameters:
      - name: organisationAuthorityRef
        in: query
        description: The authority reference of the organisation who owns the zones. Used as a replacement for internal organisation ID.
        required: true
        style: form
        explode: true
        schema:
          type: string
      - name: time
        in: query
        description: The time at which the zones are active to export
        required: false
        style: form
        explode: true
        schema:
          type: string
          format: date-time
      responses:
        '302':
          description: Redirects to a GCS bucket URL containing the NeTEx XML export of fare zones for the given authority
          headers:
            Location:
              description: The GCS bucket URL where the NeTEx XML file can be downloaded
              required: true
              style: simple
              explode: false
              schema:
                type: string
                format: uri
                examples:
                - https://storage.googleapis.com/bucket/fare-zones/export.xml
        '400':
          description: Validation Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                  errors:
                    type: array
                    items:
                      type: string
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  errors:
                  - Detail on first error
                  - Detail on second error
                  detail: Human readable error
        '401':
          description: Not Authorized
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '403':
          description: Forbidden
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '404':
          description: Resource Not Found
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
        '500':
          description: Internal Error
          content:
            application/problem+json:
              schema:
                type: object
                properties:
                  instance:
                    type: string
                    format: uri
                  title:
                    type: string
                  status:
                    type: integer
                    format: int32
                  detail:
                    type:
                    - string
                    - 'null'
                examples:
                - instance: https://api.entur.io/distance/request/path
                  title: Reason for error
                  status: 400
                  detail: Human readable error
      security:
      - enturOpen: []
    servers:
    - url: https://api.entur.io/distance
components:
  parameters:
    X-Correlation-Id:
      name: X-Correlation-Id
      in: header
      description: Correlation id
      required: false
      style: simple
      explode: false
      schema:
        type: string
    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
  securitySchemes:
    enturOpen:
      type: apiKey
      name: ET-Client-Name
      in: header
x-refined-from:
- entur-prdudisapi-openapi.json
- entur-prdudisapi-openapi.yml