openapi: 3.2.0
info:
  title: Entur Groupings API
  version: 2026.05.0
  contact:
    name: Entur API Support
    url: https://developer.entur.org
  description: 'Operations tagged Groupings across 2 of this provider''s published API definitions: entur-stop-place-v1-read-openapi.json, entur-stop-place-v1-read-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.entur.io/stop-places/v1/read
tags:
- name: Groupings
  description: Access logical groupings of stop places and fare zones for organizational and operational purposes.
paths:
  /groups-of-stop-places:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Groupings
      summary: List groups of stop places
      description: Retrieves a paginated list of stop place groups providing logical collections of stop places for organizational purposes. Supports both JSON (default) and XML formats via Accept header.
      operationId: getGroupOfStopPlaces
      parameters:
      - name: count
        in: query
        description: Maximum number of results to return per page. Supported up to 1000; larger values are best-effort and may be limited or rejected — page with skip/count or use the bulk NeTEx export for the full dataset.
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
          default: 20
        example: 20
      - name: skip
        in: query
        description: Number of results to skip for pagination
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
          default: 0
        example: 0
      - name: ids
        in: query
        description: Filter by specific group IDs
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: Successfully retrieved list of stop place groups
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GroupOfStopPlaces'
              examples:
                Groups of Stop Places List:
                  summary: Example list of stop place groups
                  description: Groups of Stop Places List
                  value:
                  - id: NSR:GroupOfStopPlaces:1
                    version: '13'
                    name:
                      value: Oslo
                      lang: nor
                    centroid:
                      location:
                        longitude: 10.748128
                        latitude: 59.911076
                    members:
                      stopPlaceRef:
                      - ref: NSR:StopPlace:58366
                      - ref: NSR:StopPlace:59872
            application/xml:
              schema:
                $ref: '#/components/schemas/GroupsOfStopPlacesInFrame_RelStructure'
              examples:
                Groups of Stop Places XML:
                  summary: Example list in NeTEx XML format
                  description: Groups of Stop Places XML
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<groupsOfStopPlaces xmlns=\"http://www.netex.org.uk/netex\">\n  <GroupOfStopPlaces id=\"NSR:GroupOfStopPlaces:1\" version=\"13\">\n    <Name lang=\"nor\">Oslo</Name>\n    <Centroid>\n      <Location>\n        <Longitude>10.748128</Longitude>\n        <Latitude>59.911076</Latitude>\n      </Location>\n    </Centroid>\n    <members>\n      <StopPlaceRef ref=\"NSR:StopPlace:58366\"/>\n      <StopPlaceRef ref=\"NSR:StopPlace:59872\"/>\n    </members>\n  </GroupOfStopPlaces>\n</groupsOfStopPlaces>\n"
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GroupOfStopPlaces'
    servers:
    - url: https://api.entur.io/stop-places/v1/read
  /groups-of-stop-places/{id}:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Groupings
      summary: Get group of stop places by ID
      description: Retrieves detailed information about a specific stop place group including its name, purpose, and list of member stop places. Supports both JSON (default) and XML formats via Accept header.
      operationId: getGroupOfStopPlacesById
      parameters:
      - name: id
        in: path
        description: Unique identifier for the stop place group
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: NSR:GroupOfStopPlaces:1
      responses:
        '200':
          description: Successfully retrieved stop place group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupOfStopPlaces'
              examples:
                Group of Stop Places:
                  summary: Example stop place group
                  description: Group of Stop Places
                  value:
                    id: NSR:GroupOfStopPlaces:1
                    version: '13'
                    name:
                      value: Oslo
                      lang: nor
                    centroid:
                      location:
                        longitude: 10.748128
                        latitude: 59.911076
                    members:
                      stopPlaceRef:
                      - ref: NSR:StopPlace:58366
                      - ref: NSR:StopPlace:59872
                      - ref: NSR:StopPlace:58293
                      - ref: NSR:StopPlace:58382
                    purposeOfGroupingRef:
                      ref: NSR:PurposeOfGrouping:1
            application/xml:
              schema:
                $ref: '#/components/schemas/GroupOfStopPlaces'
              examples:
                Group of Stop Places XML:
                  summary: Example in NeTEx XML format
                  description: Group of Stop Places XML
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<GroupOfStopPlaces xmlns=\"http://www.netex.org.uk/netex\" id=\"NSR:GroupOfStopPlaces:1\" version=\"13\">\n  <Name lang=\"nor\">Oslo</Name>\n  <Centroid>\n    <Location>\n      <Longitude>10.748128</Longitude>\n      <Latitude>59.911076</Latitude>\n    </Location>\n  </Centroid>\n  <members>\n    <StopPlaceRef ref=\"NSR:StopPlace:58366\"/>\n    <StopPlaceRef ref=\"NSR:StopPlace:59872\"/>\n  </members>\n  <PurposeOfGroupingRef ref=\"NSR:PurposeOfGrouping:1\"/>\n</GroupOfStopPlaces>\n"
        '404':
          description: Group not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupOfStopPlaces'
            application/xml:
              schema:
                $ref: '#/components/schemas/GroupOfStopPlaces'
    servers:
    - url: https://api.entur.io/stop-places/v1/read
  /groups-of-tariff-zones:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Groupings
      summary: List groups of tariff zones
      description: Retrieves a paginated list of tariff zone groups organizing fare zones into logical collections for ticketing and pricing purposes. Supports both JSON (default) and XML formats via Accept header.
      operationId: getGroupsOfTariffZones
      parameters:
      - name: count
        in: query
        description: Maximum number of results to return per page. Supported up to 1000; larger values are best-effort and may be limited or rejected — page with skip/count or use the bulk NeTEx export for the full dataset.
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
          default: 10
        example: 10
      - name: skip
        in: query
        description: Number of results to skip for pagination
        required: false
        style: form
        explode: true
        schema:
          type: integer
          format: int32
          default: 0
        example: 0
      - name: ids
        in: query
        description: Filter by specific tariff zone group IDs
        required: false
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      responses:
        '200':
          description: Successfully retrieved list of tariff zone groups
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GroupOfTariffZones'
              examples:
                Groups of Tariff Zones List:
                  summary: Example list of tariff zone groups
                  description: Groups of Tariff Zones List
                  value:
                  - id: RUT:GroupOfTariffZones:1
                    version: '1'
                    name:
                      value: Ruter sonenett
                      lang: nor
                    members:
                      tariffZoneRef:
                      - ref: RUT:TariffZone:1
                      - ref: RUT:TariffZone:2V
            application/xml:
              schema:
                $ref: '#/components/schemas/GroupsOfTariffZonesInFrame_RelStructure'
              examples:
                Groups of Tariff Zones XML:
                  summary: Example list in NeTEx XML format
                  description: Groups of Tariff Zones XML
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<groupsOfTariffZones xmlns=\"http://www.netex.org.uk/netex\">\n  <GroupOfTariffZones id=\"RUT:GroupOfTariffZones:1\" version=\"1\">\n    <Name lang=\"nor\">Ruter sonenett</Name>\n    <members>\n      <TariffZoneRef ref=\"RUT:TariffZone:1\"/>\n      <TariffZoneRef ref=\"RUT:TariffZone:2V\"/>\n    </members>\n  </GroupOfTariffZones>\n</groupsOfTariffZones>\n"
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/GroupOfTariffZones'
    servers:
    - url: https://api.entur.io/stop-places/v1/read
  /groups-of-tariff-zones/{id}:
    parameters:
    - $ref: '#/components/parameters/ET-Client-Name'
    - $ref: '#/components/parameters/X-Correlation-Id'
    get:
      tags:
      - Groupings
      summary: Get group of tariff zones by ID
      description: Retrieves detailed information about a specific tariff zone group including member zones and pricing relationships. Supports both JSON (default) and XML formats via Accept header.
      operationId: getGroupOfTariffZonesById
      parameters:
      - name: id
        in: path
        description: Unique identifier for the tariff zone group
        required: true
        style: simple
        explode: false
        schema:
          type: string
        example: RUT:GroupOfTariffZones:1
      responses:
        '200':
          description: Successfully retrieved tariff zone group
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupOfTariffZones'
              examples:
                Group of Tariff Zones:
                  summary: Example tariff zone group
                  description: Group of Tariff Zones
                  value:
                    id: RUT:GroupOfTariffZones:1
                    version: '1'
                    name:
                      value: Ruter sonenett
                      lang: nor
                    members:
                      tariffZoneRef:
                      - ref: RUT:TariffZone:1
                      - ref: RUT:TariffZone:2V
                      - ref: RUT:TariffZone:3V
            application/xml:
              schema:
                $ref: '#/components/schemas/GroupOfTariffZones'
              examples:
                Group of Tariff Zones XML:
                  summary: Example in NeTEx XML format
                  description: Group of Tariff Zones XML
                  value: "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<GroupOfTariffZones xmlns=\"http://www.netex.org.uk/netex\" id=\"RUT:GroupOfTariffZones:1\" version=\"1\">\n  <Name lang=\"nor\">Ruter sonenett</Name>\n  <members>\n    <TariffZoneRef ref=\"RUT:TariffZone:1\"/>\n    <TariffZoneRef ref=\"RUT:TariffZone:2V\"/>\n  </members>\n</GroupOfTariffZones>\n"
        '404':
          description: Tariff zone group not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GroupOfTariffZones'
    servers:
    - url: https://api.entur.io/stop-places/v1/read
components:
  schemas:
    LocationStructure:
      type: object
      properties:
        altitude:
          type: number
          xml:
            name: Altitude
        id:
          type: string
          xml:
            attribute: true
        latitude:
          type: number
          xml:
            name: Latitude
        longitude:
          type: number
          xml:
            name: Longitude
        pos:
          $ref: '#/components/schemas/DirectPositionType'
          xml:
            namespace: http://www.opengis.net/gml/3.2
        precision:
          type: number
          xml:
            name: Precision
        srsName:
          type: string
          xml:
            attribute: true
    GroupsOfTariffZonesInFrame_RelStructure:
      type: object
      properties:
        groupOfTariffZones:
          type: array
          items:
            $ref: '#/components/schemas/GroupOfTariffZones'
          xml:
            name: GroupOfTariffZones
        id:
          type: string
          xml:
            attribute: true
        modificationSet:
          type: string
          enum:
          - ALL
          - CHANGES_ONLY
          xml:
            attribute: true
      required:
      - groupOfTariffZones
    MultilingualString:
      type: object
      properties:
        lang:
          type: string
          xml:
            attribute: true
        textIdType:
          type: string
          xml:
            attribute: true
        value:
          type: string
    GroupOfStopPlaces:
      type: object
      properties:
        airSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - INTERNATIONAL_FLIGHT
          - DOMESTIC_FLIGHT
          - INTERCONTINENTAL_FLIGHT
          - DOMESTIC_SCHEDULED_FLIGHT
          - SHUTTLE_FLIGHT
          - INTERCONTINENTAL_CHARTER_FLIGHT
          - INTERNATIONAL_CHARTER_FLIGHT
          - ROUND_TRIP_CHARTER_FLIGHT
          - SIGHTSEEING_FLIGHT
          - HELICOPTER_SERVICE
          - DOMESTIC_CHARTER_FLIGHT
          - SCHENGEN_AREA_FLIGHT
          - AIRSHIP_SERVICE
          - SHORT_HAUL_INTERNATIONAL_FLIGHT
          xml:
            name: AirSubmode
        alternativeNames:
          $ref: '#/components/schemas/AlternativeNames_RelStructure'
        alternativeTexts:
          $ref: '#/components/schemas/AlternativeTexts_RelStructure'
        brandingRef:
          $ref: '#/components/schemas/BrandingRefStructure'
          xml:
            name: BrandingRef
        busSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - LOCAL_BUS
          - REGIONAL_BUS
          - EXPRESS_BUS
          - NIGHT_BUS
          - POST_BUS
          - SPECIAL_NEEDS_BUS
          - MOBILITY_BUS
          - MOBILITY_BUS_FOR_REGISTERED_DISABLED
          - SIGHTSEEING_BUS
          - SHUTTLE_BUS
          - HIGH_FREQUENCY_BUS
          - DEDICATED_LANE_BUS
          - SCHOOL_BUS
          - SCHOOL_AND_PUBLIC_SERVICE_BUS
          - RAIL_REPLACEMENT_BUS
          - DEMAND_AND_RESPONSE_BUS
          - AIRPORT_LINK_BUS
          xml:
            name: BusSubmode
        centroid:
          $ref: '#/components/schemas/SimplePoint_VersionStructure'
          xml:
            name: Centroid
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        coachSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - INTERNATIONAL_COACH
          - NATIONAL_COACH
          - SHUTTLE_COACH
          - REGIONAL_COACH
          - SPECIAL_COACH
          - SCHOOL_COACH
          - SIGHTSEEING_COACH
          - TOURIST_COACH
          - COMMUTER_COACH
          xml:
            name: CoachSubmode
        compatibleWithVersionFrameVersionRef:
          type: string
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        dataSourceRef:
          type: string
          xml:
            attribute: true
        derivedFromObjectRef:
          type: string
          xml:
            attribute: true
        derivedFromVersionRef_BasicModificationDetailsGroup:
          type: string
          xml:
            name: derivedFromVersionRef
            attribute: true
        description:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Description
        extensions:
          $ref: '#/components/schemas/ExtensionsStructure'
          xml:
            name: Extensions
        funicularSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - FUNICULAR
          - STREET_CABLE_CAR
          - ALL_FUNICULAR_SERVICES
          - UNDEFINED_FUNICULAR
          xml:
            name: FunicularSubmode
        id:
          type: string
          xml:
            attribute: true
        infoLinks:
          $ref: '#/components/schemas/InfoLinks'
        keyList:
          $ref: '#/components/schemas/KeyListStructure'
        members:
          $ref: '#/components/schemas/StopPlaceRefs_RelStructure'
        metroSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - METRO
          - TUBE
          - URBAN_RAILWAY
          xml:
            name: MetroSubmode
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        name:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Name
        nameOfClass:
          type: string
          xml:
            attribute: true
        polygon:
          $ref: '#/components/schemas/PolygonType'
          xml:
            name: Polygon
            namespace: http://www.opengis.net/gml/3.2
        privateCode:
          $ref: '#/components/schemas/PrivateCodeStructure'
          xml:
            name: PrivateCode
        publicCode:
          type: string
          xml:
            name: PublicCode
        publication:
          type: string
          enum:
          - PUBLIC
          - RESTRICTED
          - PRIVATE
          - CONFIDENTIAL
          - AUTHORISED
          - TEST
          xml:
            attribute: true
        purposeOfGroupingRef:
          $ref: '#/components/schemas/PurposeOfGroupingRefStructure'
          xml:
            name: PurposeOfGroupingRef
        railSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - LOCAL
          - HIGH_SPEED_RAIL
          - SUBURBAN_RAILWAY
          - REGIONAL_RAIL
          - INTERREGIONAL_RAIL
          - LONG_DISTANCE
          - INTERNATIONAL
          - SLEEPER_RAIL_SERVICE
          - NIGHT_RAIL
          - CAR_TRANSPORT_RAIL_SERVICE
          - TOURIST_RAILWAY
          - AIRPORT_LINK_RAIL
          - RAIL_SHUTTLE
          - REPLACEMENT_RAIL_SERVICE
          - SPECIAL_TRAIN
          - CROSS_COUNTRY_RAIL
          - RACK_AND_PINION_RAILWAY
          xml:
            name: RailSubmode
        responsibilitySetRef:
          type: string
          xml:
            attribute: true
        shortName:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: ShortName
        snowAndIceSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - SNOW_MOBILE
          - SNOW_CAT
          - SNOW_COACH
          - TERRA_BUS
          - WIND_SLED
          xml:
            name: SnowAndIceSubmode
        status_BasicModificationDetailsGroup:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - OTHER
          xml:
            name: status
            attribute: true
        telecabinSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - TELECABIN
          - CABLE_CAR
          - LIFT
          - CHAIR_LIFT
          - DRAG_LIFT
          - TELECABIN_LINK
          xml:
            name: TelecabinSubmode
        tramSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - CITY_TRAM
          - LOCAL_TRAM
          - REGIONAL_TRAM
          - SIGHTSEEING_TRAM
          - SHUTTLE_TRAM
          - TRAIN_TRAM
          xml:
            name: TramSubmode
        transportMode:
          type: string
          enum:
          - ALL
          - UNKNOWN
          - BUS
          - TROLLEY_BUS
          - TRAM
          - COACH
          - RAIL
          - INTERCITY_RAIL
          - URBAN_RAIL
          - METRO
          - AIR
          - WATER
          - CABLEWAY
          - FUNICULAR
          - SNOW_AND_ICE
          - TAXI
          - FERRY
          - LIFT
          - SELF_DRIVE
          - ANY_MODE
          - OTHER
          xml:
            name: TransportMode
        validBetween:
          type: array
          items:
            $ref: '#/components/schemas/ValidBetween'
          xml:
            name: ValidBetween
        validityConditions:
          $ref: '#/components/schemas/ValidityConditions_RelStructure'
        version:
          type: string
          xml:
            attribute: true
        waterSubmode:
          type: string
          default: unknown
          enum:
          - UNKNOWN
          - UNDEFINED
          - INTERNATIONAL_CAR_FERRY
          - NATIONAL_CAR_FERRY
          - REGIONAL_CAR_FERRY
          - LOCAL_CAR_FERRY
          - INTERNATIONAL_PASSENGER_FERRY
          - NATIONAL_PASSENGER_FERRY
          - REGIONAL_PASSENGER_FERRY
          - LOCAL_PASSENGER_FERRY
          - POST_BOAT
          - TRAIN_FERRY
          - ROAD_FERRY_LINK
          - AIRPORT_BOAT_LINK
          - HIGH_SPEED_VEHICLE_SERVICE
          - HIGH_SPEED_PASSENGER_SERVICE
          - SIGHTSEEING_SERVICE
          - SCHOOL_BOAT
          - CABLE_FERRY
          - RIVER_BUS
          - SCHEDULED_FERRY
          - SHUTTLE_FERRY_SERVICE
          - CANAL_BARGE
          xml:
            name: WaterSubmode
      xml:
        name: GroupOfStopPlaces
        namespace: http://www.netex.org.uk/netex
    JAXBElementAbstractRingType:
      type: object
      properties:
        globalScope:
          type: boolean
        name:
          type: object
          properties:
            localPart:
              type: string
            namespaceURI:
              type: string
            prefix:
              type: string
        nil:
          type: boolean
        typeSubstituted:
          type: boolean
        value:
          $ref: '#/components/schemas/AbstractRingType'
    ValidityConditionRefStructure:
      type: object
      properties:
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfRefClass:
          type: string
          xml:
            attribute: true
        ref:
          type: string
          xml:
            attribute: true
        value:
          type: string
        version:
          type: string
          xml:
            attribute: true
        versionRef:
          type: string
          xml:
            attribute: true
    ValidityConditions_RelStructure:
      type: object
      properties:
        id:
          type: string
          xml:
            attribute: true
        modificationSet:
          type: string
          enum:
          - ALL
          - CHANGES_ONLY
          xml:
            attribute: true
        validityConditionRefOrValidBetweenOrValidityCondition_:
          type: array
          items: {}
    AlternativeText:
      type: object
      properties:
        alternativeTexts: {}
        attributeName:
          type: string
          xml:
            attribute: true
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        compatibleWithVersionFrameVersionRef:
          type: string
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        dataManagedObjectRef:
          $ref: '#/components/schemas/VersionOfObjectRefStructure'
          xml:
            name: DataManagedObjectRef
        dataSourceRef:
          type: string
          xml:
            attribute: true
        derivedFromObjectRef:
          type: string
          xml:
            attribute: true
        derivedFromVersionRef_BasicModificationDetailsGroup:
          type: string
          xml:
            name: derivedFromVersionRef
            attribute: true
        extensions:
          $ref: '#/components/schemas/ExtensionsStructure'
          xml:
            name: Extensions
        id:
          type: string
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfClass:
          type: string
          xml:
            attribute: true
        order:
          type: integer
          xml:
            attribute: true
        publication:
          type: string
          enum:
          - PUBLIC
          - RESTRICTED
          - PRIVATE
          - CONFIDENTIAL
          - AUTHORISED
          - TEST
          xml:
            attribute: true
        status_BasicModificationDetailsGroup:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - OTHER
          xml:
            name: status
            attribute: true
        text:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Text
        useForLanguage:
          type: string
          xml:
            attribute: true
        validBetween:
          type: array
          items:
            $ref: '#/components/schemas/ValidBetween'
          xml:
            name: ValidBetween
        validityConditions:
          $ref: '#/components/schemas/ValidityConditions_RelStructure'
        version:
          type: string
          xml:
            attribute: true
      required:
      - text
    PurposeOfGroupingRefStructure:
      type: object
      properties:
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfRefClass:
          type: string
          xml:
            attribute: true
        ref:
          type: string
          xml:
            attribute: true
        value:
          type: string
        version:
          type: string
          xml:
            attribute: true
        versionRef:
          type: string
          xml:
            attribute: true
    SimplePoint_VersionStructure:
      type: object
      properties:
        alternativeTexts:
          $ref: '#/components/schemas/AlternativeTexts_RelStructure'
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        compatibleWithVersionFrameVersionRef:
          type: string
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        dataSourceRef:
          type: string
          xml:
            attribute: true
        derivedFromObjectRef:
          type: string
          xml:
            attribute: true
        derivedFromVersionRef_BasicModificationDetailsGroup:
          type: string
          xml:
            name: derivedFromVersionRef
            attribute: true
        id:
          type: string
          xml:
            attribute: true
        location:
          $ref: '#/components/schemas/LocationStructure'
          xml:
            name: Location
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        name:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Name
        nameOfClass:
          type: string
          xml:
            attribute: true
        publication:
          type: string
          enum:
          - PUBLIC
          - RESTRICTED
          - PRIVATE
          - CONFIDENTIAL
          - AUTHORISED
          - TEST
          xml:
            attribute: true
        status_BasicModificationDetailsGroup:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - OTHER
          xml:
            name: status
            attribute: true
        validBetween:
          type: array
          items:
            $ref: '#/components/schemas/ValidBetween'
          xml:
            name: ValidBetween
        validityConditions:
          $ref: '#/components/schemas/ValidityConditions_RelStructure'
        version:
          type: string
          xml:
            attribute: true
    ErrorResponse:
      type: object
      description: Error response returned when a request fails
      properties:
        details:
          type: object
          additionalProperties: {}
          description: Additional error context
        errorCode:
          type: string
          description: Machine-readable error code
          example: RESOURCE_NOT_FOUND
        message:
          type: string
          description: Human-readable error message
          example: Resource not found
      xml:
        name: error
    AlternativeName:
      type: object
      properties:
        abbreviation:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Abbreviation
        alternativeTexts:
          $ref: '#/components/schemas/AlternativeTexts_RelStructure'
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        compatibleWithVersionFrameVersionRef:
          type: string
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        dataSourceRef:
          type: string
          xml:
            attribute: true
        derivedFromObjectRef:
          type: string
          xml:
            attribute: true
        derivedFromVersionRef_BasicModificationDetailsGroup:
          type: string
          xml:
            name: derivedFromVersionRef
            attribute: true
        extensions:
          $ref: '#/components/schemas/ExtensionsStructure'
          xml:
            name: Extensions
        id:
          type: string
          xml:
            attribute: true
        lang:
          type: string
          xml:
            name: Lang
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        name:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Name
        nameOfClass:
          type: string
          xml:
            attribute: true
        nameType:
          type: string
          default: alias
          enum:
          - ALIAS
          - TRANSLATION
          - COPY
          - LABEL
          - OTHER
          xml:
            name: NameType
        namedObjectRef:
          $ref: '#/components/schemas/VersionOfObjectRefStructure'
          xml:
            name: NamedObjectRef
        order:
          type: integer
          xml:
            attribute: true
        publication:
          type: string
          enum:
          - PUBLIC
          - RESTRICTED
          - PRIVATE
          - CONFIDENTIAL
          - AUTHORISED
          - TEST
          xml:
            attribute: true
        qualifierName:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: QualifierName
        shortName:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: ShortName
        status_BasicModificationDetailsGroup:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - OTHER
          xml:
            name: status
            attribute: true
        typeOfName:
          type: string
          xml:
            name: TypeOfName
        validBetween:
          type: array
          items:
            $ref: '#/components/schemas/ValidBetween'
          xml:
            name: ValidBetween
        validityConditions:
          $ref: '#/components/schemas/ValidityConditions_RelStructure'
        version:
          type: string
          xml:
            attribute: true
      required:
      - name
    DirectPositionType:
      type: object
      properties:
        srsDimension:
          type: integer
          xml:
            attribute: true
        srsName:
          type: string
          xml:
            attribute: true
        value:
          type: array
          items:
            type: number
            format: double
    AbstractRingPropertyType:
      type: object
      properties:
        abstractRing:
          $ref: '#/components/schemas/JAXBElementAbstractRingType'
    AbstractRingType: {}
    KeyValueStructure:
      type: object
      properties:
        key:
          type: string
          xml:
            name: Key
        typeOfKey:
          type: string
          xml:
            attribute: true
        value:
          type: string
          xml:
            name: Value
      required:
      - key
      - value
    PolygonType:
      type: object
      properties:
        descriptionReference:
          $ref: '#/components/schemas/ReferenceType'
        exterior:
          $ref: '#/components/schemas/AbstractRingPropertyType'
        id:
          type: string
          xml:
            namespace: http://www.opengis.net/gml/3.2
            attribute: true
        identifier:
          $ref: '#/components/schemas/CodeWithAuthorityType'
        interior:
          type: array
          items:
            $ref: '#/components/schemas/AbstractRingPropertyType'
        name:
          type: array
          items:
            $ref: '#/components/schemas/CodeType'
        srsDimension:
          type: integer
          xml:
            attribute: true
        srsName:
          type: string
          xml:
            attribute: true
    CodeType:
      type: object
      properties:
        codeSpace:
          type: string
          xml:
            attribute: true
        value:
          type: string
    GroupsOfStopPlacesInFrame_RelStructure:
      type: object
      properties:
        groupOfStopPlaces:
          type: array
          items:
            $ref: '#/components/schemas/GroupOfStopPlaces'
          xml:
            name: GroupOfStopPlaces
        id:
          type: string
          xml:
            attribute: true
        modificationSet:
          type: string
          enum:
          - ALL
          - CHANGES_ONLY
          xml:
            attribute: true
      required:
      - groupOfStopPlaces
    BrandingRefStructure:
      type: object
      properties:
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfRefClass:
          type: string
          xml:
            attribute: true
        ref:
          type: string
          xml:
            attribute: true
        value:
          type: string
        version:
          type: string
          xml:
            attribute: true
        versionRef:
          type: string
          xml:
            attribute: true
    CodeWithAuthorityType:
      type: object
      properties:
        codeSpace:
          type: string
          xml:
            attribute: true
        value:
          type: string
    ExtensionsStructure:
      type: object
      properties:
        any:
          type: array
          items: {}
    StopPlaceRefs_RelStructure:
      type: object
      properties:
        id:
          type: string
          xml:
            attribute: true
        modificationSet:
          type: string
          enum:
          - ALL
          - CHANGES_ONLY
          xml:
            attribute: true
        stopPlaceRef:
          type: array
          items:
            $ref: '#/components/schemas/StopPlaceRefStructure'
          xml:
            name: StopPlaceRef
      required:
      - stopPlaceRef
    TariffZoneRefs_RelStructure:
      type: object
      properties:
        id:
          type: string
          xml:
            attribute: true
        modificationSet:
          type: string
          enum:
          - ALL
          - CHANGES_ONLY
          xml:
            attribute: true
        tariffZoneRef:
          type: array
          items:
            $ref: '#/components/schemas/TariffZoneRef'
          xml:
            name: TariffZoneRef
      required:
      - tariffZoneRef
    InfoLinkStructure:
      type: object
      properties:
        targetPlatform:
          type: string
          xml:
            attribute: true
        typeOfInfoLink:
          type: array
          items:
            type: string
            enum:
            - CONTACT
            - RESOURCE
            - INFO
            - IMAGE
            - DOCUMENT
            - TIMETABLE_DOCUMENT
            - FARE_SHEET
            - DATA_LICENCE
            - MOBILE_APP_DOWNLOAD
            - MOBILE_APP_INSTALL_CHECK
            - MAP
            - ICON
            - OTHER
          xml:
            attribute: true
        value:
          type: string
    ValidBetween:
      type: object
      properties:
        alternativeTexts: {}
        brandingRef:
          $ref: '#/components/schemas/BrandingRefStructure'
          xml:
            name: BrandingRef
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        compatibleWithVersionFrameVersionRef:
          type: string
          xml:
            attribute: true
        conditionedObjectRef:
          $ref: '#/components/schemas/VersionOfObjectRefStructure'
          xml:
            name: ConditionedObjectRef
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        dataSourceRef:
          type: string
          xml:
            attribute: true
        derivedFromObjectRef:
          type: string
          xml:
            attribute: true
        derivedFromVersionRef_BasicModificationDetailsGroup:
          type: string
          xml:
            name: derivedFromVersionRef
            attribute: true
        description:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Description
        extensions:
          $ref: '#/components/schemas/ExtensionsStructure'
          xml:
            name: Extensions
        fromDate:
          type: string
          format: date-time
          xml:
            name: FromDate
        id:
          type: string
          xml:
            attribute: true
        keyList:
          $ref: '#/components/schemas/KeyListStructure'
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        name:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Name
        nameOfClass:
          type: string
          xml:
            attribute: true
        publication:
          type: string
          enum:
          - PUBLIC
          - RESTRICTED
          - PRIVATE
          - CONFIDENTIAL
          - AUTHORISED
          - TEST
          xml:
            attribute: true
        responsibilitySetRef:
          type: string
          xml:
            attribute: true
        status_BasicModificationDetailsGroup:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - OTHER
          xml:
            name: status
            attribute: true
        toDate:
          type: string
          format: date-time
          xml:
            name: ToDate
        validityConditions:
          $ref: '#/components/schemas/ValidityConditions_RelStructure'
        version:
          type: string
          xml:
            attribute: true
        withConditionRef:
          $ref: '#/components/schemas/ValidityConditionRefStructure'
          xml:
            name: WithConditionRef
      xml:
        name: ValidBetween
        namespace: http://www.netex.org.uk/netex
    AlternativeTexts_RelStructure:
      type: object
      properties:
        alternativeText:
          type: array
          items:
            $ref: '#/components/schemas/AlternativeText'
          xml:
            name: AlternativeText
        id:
          type: string
          xml:
            attribute: true
      required:
      - alternativeText
    InfoLinks:
      type: object
      properties:
        infoLink:
          type: array
          items:
            $ref: '#/components/schemas/InfoLinkStructure'
          xml:
            name: InfoLink
      required:
      - infoLink
    GroupOfTariffZones:
      type: object
      properties:
        alternativeTexts:
          $ref: '#/components/schemas/AlternativeTexts_RelStructure'
        brandingRef:
          $ref: '#/components/schemas/BrandingRefStructure'
          xml:
            name: BrandingRef
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        compatibleWithVersionFrameVersionRef:
          type: string
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        dataSourceRef:
          type: string
          xml:
            attribute: true
        derivedFromObjectRef:
          type: string
          xml:
            attribute: true
        derivedFromVersionRef_BasicModificationDetailsGroup:
          type: string
          xml:
            name: derivedFromVersionRef
            attribute: true
        description:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Description
        extensions:
          $ref: '#/components/schemas/ExtensionsStructure'
          xml:
            name: Extensions
        id:
          type: string
          xml:
            attribute: true
        infoLinks:
          $ref: '#/components/schemas/InfoLinks'
        keyList:
          $ref: '#/components/schemas/KeyListStructure'
        members:
          $ref: '#/components/schemas/TariffZoneRefs_RelStructure'
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        name:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: Name
        nameOfClass:
          type: string
          xml:
            attribute: true
        privateCode:
          $ref: '#/components/schemas/PrivateCodeStructure'
          xml:
            name: PrivateCode
        publication:
          type: string
          enum:
          - PUBLIC
          - RESTRICTED
          - PRIVATE
          - CONFIDENTIAL
          - AUTHORISED
          - TEST
          xml:
            attribute: true
        purposeOfGroupingRef:
          $ref: '#/components/schemas/PurposeOfGroupingRefStructure'
          xml:
            name: PurposeOfGroupingRef
        responsibilitySetRef:
          type: string
          xml:
            attribute: true
        shortName:
          $ref: '#/components/schemas/MultilingualString'
          xml:
            name: ShortName
        status_BasicModificationDetailsGroup:
          type: string
          enum:
          - ACTIVE
          - INACTIVE
          - OTHER
          xml:
            name: status
            attribute: true
        validBetween:
          type: array
          items:
            $ref: '#/components/schemas/ValidBetween'
          xml:
            name: ValidBetween
        validityConditions:
          $ref: '#/components/schemas/ValidityConditions_RelStructure'
        version:
          type: string
          xml:
            attribute: true
    StopPlaceRefStructure:
      type: object
      properties:
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfMemberClass:
          type: string
          xml:
            attribute: true
        nameOfRefClass:
          type: string
          xml:
            attribute: true
        ref:
          type: string
          xml:
            attribute: true
        value:
          type: string
        version:
          type: string
          xml:
            attribute: true
        versionRef:
          type: string
          xml:
            attribute: true
    TariffZoneRef:
      type: object
      properties:
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfMemberClass:
          type: string
          xml:
            attribute: true
        nameOfRefClass:
          type: string
          xml:
            attribute: true
        ref:
          type: string
          xml:
            attribute: true
        value:
          type: string
        version:
          type: string
          xml:
            attribute: true
        versionRef:
          type: string
          xml:
            attribute: true
    KeyListStructure:
      type: object
      properties:
        keyValue:
          type: array
          items:
            $ref: '#/components/schemas/KeyValueStructure'
          xml:
            name: KeyValue
      required:
      - keyValue
    PrivateCodeStructure:
      type: object
      properties:
        type:
          type: string
          xml:
            attribute: true
        value:
          type: string
    ReferenceType:
      type: object
      properties:
        nilReason:
          type: array
          items:
            type: string
          xml:
            attribute: true
        owns:
          type: boolean
          xml:
            attribute: true
    VersionOfObjectRefStructure:
      type: object
      properties:
        changed:
          type: string
          format: date-time
          xml:
            attribute: true
        created:
          type: string
          format: date-time
          xml:
            attribute: true
        modification:
          type: string
          enum:
          - NEW
          - REVISE
          - DELETE
          - UNCHANGED
          - DELTA
          xml:
            attribute: true
        nameOfRefClass:
          type: string
          xml:
            attribute: true
        ref:
          type: string
          xml:
            attribute: true
        value:
          type: string
        version:
          type: string
          xml:
            attribute: true
        versionRef:
          type: string
          xml:
            attribute: true
    AlternativeNames_RelStructure:
      type: object
      properties:
        alternativeName:
          type: array
          items:
            $ref: '#/components/schemas/AlternativeName'
          xml:
            name: AlternativeName
        id:
          type: string
          xml:
            attribute: true
      required:
      - alternativeName
  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
x-refined-from:
- entur-stop-place-v1-read-openapi.json
- entur-stop-place-v1-read-openapi.yml