Entur · Schema

SeatsReservationsResponseV1

Seat reservations for a seat offer.

CompanyPublic TransportJourney PlanningMobilityOpen DataNorwayTransitGraphQL

Properties

Name Type Description
status string Status of the seat offer.
elements array
seats array
View JSON Schema on GitHub

JSON Schema

entur-seats-reservations-response-v1-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/entur/json-schema/entur-seats-reservations-response-v1-schema.json",
  "title": "SeatsReservationsResponseV1",
  "description": "Seat reservations for a seat offer. ",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/entur-capacities-controller-api-openapi.yml#/components/schemas/SeatsReservationsResponseV1",
  "required": [
    "elements",
    "seats",
    "status"
  ],
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "description": "Status of the seat offer."
    },
    "elements": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SeatsAvailabilitiesElementResponseV1"
      }
    },
    "seats": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SeatsReservationsSeatResponseV1"
      }
    }
  },
  "$defs": {
    "ElementPartResponseV1": {
      "required": [
        "destinationStopPlace",
        "direction",
        "materialCompositionNetexId",
        "originStopPlace",
        "sequenceNumber"
      ],
      "type": "object",
      "properties": {
        "originStopPlace": {
          "$ref": "#/$defs/StopPlaceWithTimesResponseV1"
        },
        "destinationStopPlace": {
          "$ref": "#/$defs/StopPlaceWithTimesResponseV1"
        },
        "materialCompositionNetexId": {
          "type": "string",
          "description": "Netex id for corresponding material composition."
        },
        "sequenceNumber": {
          "type": "integer",
          "description": "Sequence number of the element in this material composition.",
          "format": "int32"
        },
        "direction": {
          "type": "string",
          "description": "Direction of the element in this material composition.",
          "enum": [
            "FORWARDS",
            "BACKWARDS",
            "UNKNOWN"
          ]
        }
      },
      "description": "Information about one element in one material composition."
    },
    "SeatingPropertiesResponseV1": {
      "type": "object",
      "properties": {
        "fareClass": {
          "type": [
            "string",
            "null"
          ],
          "description": "Fare class of the seat. Netex enumeration.",
          "enum": [
            "UNKNOWN",
            "FIRST_CLASS",
            "SECOND_CLASS",
            "THIRD_CLASS",
            "PREFERENTE",
            "PREMIUM_CLASS",
            "BUSINESS_CLASS",
            "STANDARD_CLASS",
            "TURISTA",
            "ECONOMY_CLASS",
            "ANY"
          ]
        },
        "groupBooking": {
          "type": [
            "string",
            "null"
          ],
          "description": "Group booking permission of the seat. Netex enumeration.",
          "enum": [
            "GROUPS_ALLOWED",
            "GROUPS_NOT_ALLOWED",
            "GROUPS_ALLOWED_WITH_RESERVATION",
            "GROUP_BOOKINGS_RESTRICTED",
            "UNKNOWN"
          ]
        },
        "accommodationFacility": {
          "type": [
            "string",
            "null"
          ],
          "description": "Accommodation property of the seat. Netex enumeration.",
          "enum": [
            "UNKNOWN",
            "SEATING",
            "FOLDING_SEAT",
            "SLEEPER",
            "SINGLE_SLEEPER",
            "DOUBLE_SLEEPER",
            "SPECIAL_SLEEPER",
            "COUCHETTE",
            "SINGLE_COUCHETTE",
            "DOUBLE_COUCHETTE",
            "SPECIAL_SEATING",
            "RECLINING_SEATS",
            "BABY_COMPARTMENT",
            "FAMILY_CARRIAGE",
            "RECREATION_AREA",
            "PANORAMA_COACH",
            "PULLMAN_COACH",
            "PUSHCHAIR",
            "WHEELCHAIR",
            "STANDING"
          ]
        },
        "seatAttachment": {
          "type": [
            "string",
            "null"
          ],
          "description": "Attachment of the seat. Netex enumeration.",
          "enum": [
            "REVERSIBLE",
            "FIXED",
            "FOLDING",
            "REMOVABLE",
            "OTHER"
          ]
        },
        "seatPosition": {
          "type": [
            "string",
            "null"
          ],
          "description": "Position of the seat. Netex enumeration.",
          "enum": [
            "WINDOW",
            "AISLE",
            "MIDDLE",
            "UPPER_BERTH",
            "MIDDLE_BERTH",
            "LOWER_BERTH",
            "OTHER"
          ]
        },
        "relativeDirection": {
          "type": [
            "string",
            "null"
          ],
          "description": "Relative direction of the seat. Netex enumeration.",
          "enum": [
            "BOTH",
            "FORWARDS",
            "BACKWARDS"
          ]
        },
        "nuisanceFacilities": {
          "uniqueItems": true,
          "type": "array",
          "description": "Set of possible nuisance factors of the seat. Netex enumerations.",
          "items": {
            "type": "string",
            "description": "Set of possible nuisance factors of the seat. Netex enumerations.",
            "enum": [
              "UNKNOWN",
              "SMOKING",
              "NO_SMOKING",
              "FAMILY_AREA",
              "CHILDFREE_AREA",
              "ANIMALS_ALLOWED",
              "NO_ANIMALS",
              "BREASTFEEDING_FRIENDLY",
              "MOBILE_PHONE_USE_ZONE",
              "MOBILE_PHONE_FREE_ZONE"
            ]
          }
        },
        "passengerCommsFacilities": {
          "uniqueItems": true,
          "type": "array",
          "description": "Set of possible communication facilities available for passenger in the seat. Netex enumerations.",
          "items": {
            "type": "string",
            "description": "Set of possible communication facilities available for passenger in the seat. Netex enumerations.",
            "enum": [
              "UNKNOWN",
              "FREE_WIFI",
              "PUBLIC_WIFI",
              "POWER_SUPPLY_SOCKETS",
              "TELEPHONE",
              "AUDIO_ENTERTAINMENT",
              "VIDEO_ENTERTAINMENT",
              "BUSINESS_SERVICES",
              "INTERNET",
              "POST_OFFICE",
              "POST_BOX"
            ]
          }
        },
        "sanitaryFacilities": {
          "uniqueItems": true,
          "type": "array",
          "description": "Set of possible sanitary facilities available for passenger in the seat. Netex enumerations.",
          "items": {
            "type": "string",
            "description": "Set of possible sanitary facilities available for passenger in the seat. Netex enumerations.",
            "enum": [
              "NONE",
              "TOILET",
              "WHEELCHAIR_ACCESS_TOILET",
              "SHOWER",
              "WASHING_AND_CHANGE_FACILITIES",
              "BABY_CHANGE",
              "WHEELCHAIR_BABY_CHANGE",
              "SHOE_SHINER",
              "OTHER"
            ]
          }
        },
        "mobilityFacilities": {
          "uniqueItems": true,
          "type": "array",
          "description": "Set of possible mobility facilities available for passenger in the seat. Netex enumerations.",
          "items": {
            "type": "string",
            "description": "Set of possible mobility facilities available for passenger in the seat. Netex enumerations.",
            "enum": [
              "UNKNOWN",
              "LOW_FLOOR",
              "STEP_FREE_ACCESS",
              "SUITABLE_FOR_PUSHCHAIRS",
              "SUITABLE_FOR_WHEELCHAIRS",
              "SUITABLE_FOR_HEAVILIY_DISABLED",
              "BOARDING_ASSISTANCE",
              "ONBOARD_ASSISTANCE",
              "UNACCOMPANIED_MINOR_ASSISTANCE",
              "TACTILE_PLATFORM_EDGES",
              "TACTILE_GUIDING_STRIPS"
            ]
          }
        },
        "baggageType": {
          "uniqueItems": true,
          "type": "array",
          "description": "Set of possible baggage types possible for passenger in the seat. Netex enumerations.",
          "items": {
            "type": "string",
            "description": "Set of possible baggage types possible for passenger in the seat. Netex enumerations.",
            "enum": [
              "HANDBAG",
              "HAND_LUGGAGE",
              "SMALL_SUITCASE",
              "SUITCASE",
              "TRUNK",
              "OVERSIZE_ITEM",
              "BICYCLE",
              "MOTORCYCLE",
              "SPORTING_EQUIPMENT",
              "SKIS",
              "MUSICAL_INSTRUMENT",
              "PUSH_CHAIR",
              "WHEELCHAIR",
              "MOTORIZED_WHEELCHAIR",
              "LARGE_MOTORIZED_WHEELCHAIR",
              "SMALL_ANIMAL",
              "ANIMAL",
              "GAME",
              "OTHER"
            ]
          }
        }
      },
      "description": "Properties of a seat. They describe both physical and logical properties of a seat.Physical properties are for example position of the seat.Logical properties describe properties that the operator use when selling the seat. For example fare class."
    },
    "SeatsAvailabilitiesElementResponseV1": {
      "required": [
        "elementCarriageNumber",
        "elementNetexId",
        "elementParts",
        "series",
        "seriesVersion"
      ],
      "type": "object",
      "properties": {
        "elementNetexId": {
          "type": "string",
          "description": "Netex id of the element."
        },
        "series": {
          "type": "string",
          "description": "Rolling stock series of the element."
        },
        "seriesVersion": {
          "type": "integer",
          "description": "Rolling stock version of the element.",
          "format": "int32"
        },
        "elementCarriageNumber": {
          "type": "integer",
          "description": "Number of the element.",
          "format": "int32"
        },
        "seatmapKey": {
          "type": [
            "string",
            "null"
          ],
          "description": "Nøkkel til seatmap som tilhører elementet."
        },
        "elementParts": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ElementPartResponseV1"
          }
        }
      },
      "description": "Information about one element in the material of this seat offer."
    },
    "SeatsReservationsReservationResponseV1": {
      "required": [
        "nsrCodeDestination",
        "nsrCodeOrigin",
        "reference",
        "sequenceNrDestination",
        "sequenceNrOrigin",
        "status"
      ],
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "description": "Status of the reservation.",
          "enum": [
            "DRAFT",
            "CONFIRMED",
            "CANCELLED",
            "DEPRECATED"
          ]
        },
        "sequenceNrOrigin": {
          "type": "integer",
          "description": "Index of the origin station of the reservation.",
          "format": "int32"
        },
        "sequenceNrDestination": {
          "type": "integer",
          "description": "Index of the destination station of the reservation.",
          "format": "int32"
        },
        "nsrCodeOrigin": {
          "type": "string",
          "description": "Nsr code of the origin station of the reservation."
        },
        "nsrCodeDestination": {
          "type": "string",
          "description": "Nsr code of the destination station of the reservation."
        },
        "reference": {
          "type": "string",
          "description": "Reference of the reservation holding this seat.",
          "format": "uuid"
        },
        "orderId": {
          "type": [
            "string",
            "null"
          ],
          "description": "Optional orderId connected to this reservation"
        }
      },
      "description": "One reservation for the corresponding seat."
    },
    "SeatsReservationsSeatResponseV1": {
      "required": [
        "elementCarriageNumber",
        "properties",
        "reservations",
        "seatNumber",
        "series",
        "seriesVersion"
      ],
      "type": "object",
      "properties": {
        "seatNumber": {
          "type": "string",
          "description": "Seat number."
        },
        "elementCarriageNumber": {
          "type": "integer",
          "description": "Number of the corresponding element.",
          "format": "int32"
        },
        "properties": {
          "$ref": "#/$defs/SeatingPropertiesResponseV1"
        },
        "series": {
          "type": "string",
          "description": "Rolling stock series of the corresponding element."
        },
        "seriesVersion": {
          "type": "integer",
          "description": "Rolling stock version of the corresponding element.",
          "format": "int32"
        },
        "compartmentName": {
          "type": [
            "string",
            "null"
          ],
          "description": "A unique identifier of each compartment. If set then every seat with the same compartmentName belongs to the same physical compartment."
        },
        "reservations": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/SeatsReservationsReservationResponseV1"
          }
        }
      },
      "description": "Information about one seat in the seat offer. Only seats with reservations are listed."
    },
    "StopPlaceWithTimesResponseV1": {
      "required": [
        "arrivalDateTime",
        "departureDateTime",
        "nsrCode",
        "sequenceNr"
      ],
      "type": "object",
      "properties": {
        "nsrCode": {
          "type": "string",
          "description": "Stop Place id defined by National StopPlace registry."
        },
        "departureDateTime": {
          "type": "string",
          "description": "Time of departure from this stop. Set to time of arrival on last stop.",
          "format": "date-time"
        },
        "arrivalDateTime": {
          "type": "string",
          "description": "Time of arrival on this stop. Set to time of departure on first stop.",
          "format": "date-time"
        },
        "sequenceNr": {
          "type": "integer",
          "description": "The ordering of the station in the journey.",
          "format": "int32"
        }
      },
      "description": "Destination stop place for this element in this material composition."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/entur-seats-reservations-response-v1"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API 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.