Types ​

Get location matching given query string

Get all available locations

Get journeys between origin and destination on given date

Get fares for given journey, prefer socket

Get journey for given blueprint

Get applicable pass bundles for given passengers

Get applicable pass bundles for given journey offer

Get comparative rating for journeys

Get fee for issuing tickets

Get anything with an ID

Get sales agent details

Create a booking

Update an existing booking

Update an offer part of a booking

Create a payment which, once fulfilled, will create and finalize the order

Confirm booking selections and prebook fares

Finalize order and fetch tickets

Get journeys between origin and destination on given date

Get fares for given journey

Get journey for given blueprint

A station where stops may be made but journeys cannot be planned from/to

Ticket availablility

Accommodation details for a journey segment.

Describes the type of seating or sleeping arrangement available on a train/bus/ferry, including comfort level and specific features. Used to help passengers choose their preferred travel experience.

The description field provides human-readable details about the accommodation (e.g. "1 person sleeper cabin"), while subType contains a standardized code representation of the same information (e.g., "SINGLE").

The admission (tariff) part of an offer.

Represents the right to travel for the covered segments (the fare/tariff). Contains refund/exchange conditions and the flexibility level, as well as the normalized serviceClass and (operator-specific) comfortClass.

An ancillary service that can be selected for a reservation.

Additional services or add-ons that passengers can purchase beyond the basic fare. These enhance the travel experience and may include meals, insurance, or special assistance.

Common types and examples:

• "BREAKFAST": On-board breakfast, pre-ordered meals
• "MEAL": On-board dining, pre-ordered meals
• "INSURANCE": Travel insurance, cancellation protection
• "LUGGAGE": Extra baggage allowance, bike transport
• "UPGRADE": Seat upgrades, priority boarding
• "ENTERTAINMENT": WiFi access, entertainment packages

The price field indicates the additional cost, while selections track which passengers have chosen this service.

A selection of an ancillary service

A journey constructed from a predefined itinerary blueprint.

Uses a curated sequence of segments and optional stopovers defined by a blueprint. Blueprints are suitable for editorial or productized routes (e.g. scenic itineraries, recommended routes, or multi-city trips) and can include planned overnight stopovers.

Typical use cases:

• Publishing recommended routes with fixed or suggested stopovers
• Recreating saved or shared itineraries
• Ensuring specific paths or operators are used

A bookable fare offer for a journey

Represents a temporary booking that holds selected offers, pass bundles, and passenger information before payment and confirmation. Bookings have a limited lifespan and must be confirmed before expiration.

If expiresAt is reached without confirmation, or if the booking fails for any reason, the booking is automatically cancelled and offers are released back to inventory. An expired or failed booking cannot be used again and will need to be recreated from scratch.

A compartment type for a fare, e.g. Sleeper or Couchette

Resource that can be accessed for check-in and ticket issuing

All passenger details

File resource

Coordinates of a given location in GeoJSON Point format.

Follows the GeoJSON specification (RFC 7946) using WGS84 coordinate system. Coordinates are stored as [longitude, latitude] array (note the order).

Examples:

• London: [-0.1278, 51.5074] (longitude, latitude)
• Rome: [12.4964, 41.9028] (longitude, latitude)
• Stockholm: [18.0686, 59.3293] (longitude, latitude)
• Berlin: [13.4050, 52.5200] (longitude, latitude)

Note: The type field is always "Point" for this implementation.

An unspecified item in an order

Fare result produced by a given journey

The journey selected for an offer

A fare offer for a journey

Selected journey offer that is part of a booking

A booked journey from a journey offer, containing segments, tickets and other resources

Known location from and to which journeys can be planned

Monetary sum using CLDR (Common Locale Data Repository) format.

The amount field represents the monetary value in the smallest currency unit:

• For currencies with decimal places (USD, EUR, GBP, etc.): amount is in cents (e.g., 1000 = $10.00, 1250 = €12.50)
• For currencies without decimal places (JPY, KRW, etc.): amount is in whole units (e.g., 1000 = ¥1000, 1250 = ¥1250)

Users are advised to consult the CLDR specification for proper currency formatting and display. The currency field contains the ISO 4217 currency code (e.g., "USD", "EUR", "JPY").

Examples:

• USD 1000 = $10.00 (1000 cents)
• EUR 1250 = €12.50 (1250 euro cents)
• JPY 1000 = ¥1000 (1000 yen, no decimal places)
• KRW 5000 = ₩5000 (5000 won, no decimal places)

A direct journey with no planned stopovers.

Represents the optimal (fastest) end-to-end route from origin to destination without overnight stopovers. Transfers between trains may still occur, but the itinerary does not intentionally include long breaks or multi-day segments.

While this optimizes for speed, it may result in less comfortable connections that require transfers at inconvenient times.

Use when passengers want the fastest connection in a single travel day where possible.

Payment type used when no payment is required.

This payment type is used in cases where:

• The booking has a total price of 0
• The booking has been fully paid with gift cards or credits
• The booking is being processed through an agent with direct billing

The URL field will redirect to the provided successUrl.

Operator details

A priced, bookable combination of entitlements for a journey.

An offer bundles everything needed to travel on a ticketable segment of an itinerary. It is made up of one or more parts:

• AdmissionPart: the right-to-travel/tariff entitlement (admission to board)
• ReservationPart: optional seat/berth reservations and add-ons

Pricing and composition:

• price: total price for all included parts in the requested currency
• parts: per-part breakdown with their own price and the segments they cover

Usage:

• returned by journey pricing endpoints and attached to itinerary results
• selected when creating a booking (see JourneyOfferSelection and OfferSelectionInput)
• per-part options (e.g., placeProperties, ancillaries) are configured on ReservationPart items

Notes:

• Some connections can be traveled without a reservation; such offers only have an AdmissionPart
• Sometimes reservations are included, in which case a ReservationPart with no price is returned
• Long or mixed-operator journeys may include multiple AdmissionPart and ReservationPart items, each covering different segments

Finalized order with confirmed bookings and issued tickets.

Represents a completed transaction where payment has been processed, offers have been confirmed, and tickets have been or are being issued. Orders are the final state of a booking and contain all travel documentation.

The reference field is typically used for customer service inquiries.

Period for which a serivce is scheduled to run

Option relating to the seating arrangement and other aspects of the journey.

Allows passengers to specify preferences for their travel experience, such as seat location, cabin type, or special requirements. These properties can be required (mandatory selection) or optional (preference-based).

Common property types:

• "GENDER": Segregated cabin by gender
• "PLACE_OR_COMPARTMENT_LOCATION": Location of the place or compartment
• "SPECIAL_COMPARTMENT_TYPE": Special compartment type

The availableOptions list shows all possible choices, while selectedOption indicates the passenger's current preference.

An option for a place property.

Represents a specific choice within a place property category. These options are what passengers can select from when choosing their preferences.

Examples by property type:

• GENDER: "MEN", "LADIES", "MIXED"
• PLACE_OR_COMPARTMENT_LOCATION: "WINDOW", "AISLE", "FRONT", "BACK"
• SPECIAL_COMPARTMENT_TYPE: "EASY_ACCESS", "WITHOUT_ANIMALS", "QUIET_ZONE"

The value field contains the standardized identifier for the option, while the id field provides a unique reference for selection tracking.

Possible place preferences

Passengers grouped by type for fare calculation and pass bundle allocation.

Represents a count of passengers of the same type that will be traveling together. This grouping is used to:

• Calculate group fares and discounts
• Allocate rail passes and other travel products

The count field represents the number of passengers of this specific type.

Bundle of rail passes and similar travel products.

Represents a collection of travel passes that can be purchased together, typically for multiple passengers or extended travel periods. These bundles provide access to train networks across multiple countries.

Pass structure:

• class: "1stclass" (first class travel) or "2ndclass" (second class travel)
• product: "interrail-global-pass" (33 countries), "eurail-one-country-pass-sweden" (single country)
• travelDayCount: Number of days the pass can be used for travel within the validity period
• validityPeriod: Overall time window when the pass is valid

Pass types:

• Continuous passes: travelDayCount is null (unlimited daily travel during validity period)
• Flexi passes: travelDayCount specifies exact number of travel days within validity period

The minium passenger details

Details required for all passengers on a specific booking.

Defines which passenger information fields are mandatory for a particular booking. Requirements are determined by ticketing providers and vary depending on the operator being used.

Selected Interrail bundle that is part of a booking

Ticket issued in PDF format for download

A booked rail pass from a pass bundle offer, containing passenger details and pass information

The reservation part of an offer.

Represents the seat/berth reservation(s) and related options for the covered segments. May expose configurable placeProperties (e.g., window/aisle, quiet-zone) and optional ancillaries (e.g., luggage, meals). price reflects the reservation cost for the part; the offer total is on Offer.price.

The conditions for returning or exchanging an offer.

Defines the rules and policies that apply when a passenger needs to modify or cancel their booking. These conditions vary by offer type and operator, affecting refundability and exchange options.

The description provides human-readable policy details, while the type categorizes the return option as either refund, exchange, or unknown.

Rate limit imposed for an agent to prevent API abuse.

Implements rate limiting to ensure fair usage of the API across all agents and to protect system resources from excessive requests.

When remaining reaches 0, requests are rejected until resetAt. Specific limits are determined by the commercial agreement with each agent.

The brand of the service

Individual train segment representing a single physical train journey between two stops.

A segment is the atomic unit of travel - it represents one train/bus/ferry that travels from origin to destination, possibly with intermediate stops but no change of transport. Multiple segments can be combined to form an individual journey leg, see SegmentCollection.

Location for an overnight stopover

A collection of connected segments that form a logical journey leg.

Represents a sequence of segments that:

• Share the same availability status
• Can be booked together
• Have common offer options
• Form a continuous path between major stops

Used to group related segments together for pricing and booking purposes.

A journey that optimizes for comfort by limiting daily travel time.

For short distances, provides direct connections when available. For longer routes, automatically segments the journey into multiple days to avoid excessively long travel times. This ensures passenger comfort and builds in buffer time in case of disruptions.

Segmentation logic considers factors like night trains, connection times, and time of day to determine whether splitting into multiple days would improve the overall experience.

This is the default journey type returned by the API.

Typical use cases:

• Long-distance trips that would be exhausting in a single day
• Routes where overnight breaks improve reliability
• Itineraries benefiting from night trains or natural break points

The selected fare of a journey offer

Payment using Stripe

An authorized agent interacting with the API

The class of an available ticket, combining comfort and service levels.

Represents the quality and amenities available for a specific fare option. The comfortClass provides operator-specific classification (e.g., "1st", "2nd", "Premium"), while serviceClass gives a normalized comparison across different operators.

Examples:

• comfortClass: "1st", serviceClass: HIGH (First class with premium service)
• comfortClass: "2nd", serviceClass: STANDARD (Second class with standard service)
• comfortClass: "Premium", serviceClass: BEST (Premium class with best available service)
• comfortClass: "Economy", serviceClass: BASIC (Economy class with basic service)

Ticket which can be retrieved on departure

Any unique resource with an ID

Generic train stop

One part that makes up an offer.

Each part references the exact segments it applies to. The optional price reflects the cost of this part; the overall total is reported on Offer.price.

Journey result produced by any given search algorithm

Fare offer for given itinerary item

A passenger with minimal details

Represents a payment that needs to be processed to complete an order. The payment interface defines the common fields shared across different payment methods:

• id: Unique identifier for the payment
• url: URL where the customer can complete the payment

Different payment implementations (like StripePayment or NoChargeRedirect) may provide additional fields specific to their payment flow.

The payment URL typically redirects to a payment page hosted by All Aboard where the customer can securely enter their payment details.

Generic resource that can be accessed or downloaded.

Represents digital assets associated with orders, such as tickets, boarding passes, receipts, and other travel documents. Resources are typically accessed via URLs and may have different formats.

Common resource types:

• application/pdf: PDF tickets, receipts, and documentation
• image/png: QR codes, boarding passes, and visual elements
• text/plain: Plain text instructions and confirmations
• application/json: Structured data and API responses

Resources may have access restrictions or expiration times depending on the type and operator policies.

The mode of transport

The current status for a journey result

Status indicating whether a segment collection was successfully loaded or encountered an error

The type of passenger

The resulting product type definition for a passenger

The perferred title of a passenger (required by carriers)

Current status of an order

Type of journey

The current availability of a journey

The type of accommodation available

Flexibility of a fare

Type of return covered by a return policy

Normalized class of service

Valid agent payment method

The unit for a given rate limit

Items that can make up the itinerary of a Journey

Selections that can be part of a booking

Items that can be part of an order

A resource associated with an order

Date string (ISO 8601 – YYYY-MM-DD)

Naive date and time string, seconds omitted (ISO 8601 – YYYY-MM-DDThh:mm)

ISO 8601 formatted string, e.g. PT2H15M, P2D, P1M

The JSONObject scalar type represents JSON objects as specified by ECMA-404.

The ID scalar type represents a unique identifier, often used to refetch an object or as key for a cache. The ID type appears in a JSON response as a String; however, it is not intended to be human-readable. When expected as an input type, any string (such as "4") or integer (such as 4) input value will be accepted as an ID.

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

The Boolean scalar type represents true or false.

Via stopover for a journey to break up long trips.

Allows passengers to specify intermediate locations where they want to stop and spend time before continuing their journey. This is useful for long-distance travel where passengers want to explore cities along the way or break up overnight journeys.

Field requirements:

• uid: Required - the location UID where the stopover occurs
• duration: Optional - how long to stay (e.g., "P2D" for 2 days) If not specified, the journey will simply route via that location with a change of trains (no extended stopover)

Passenger details for passholder

Input type for basic passenger details. When specifying a passenger's age, either:

1. Provide the birthDate field with their date of birth, OR
2. Provide the age field with their age at time of travel

For passenger types YOUTH and SENIOR, one of these age fields must be provided to validate eligibility for age-based fares and discounts.

For the ADULT passenger type, age fields are optional.

Full passenger details required to complete a booking.

Represents the complete set of passenger data that may be required by ticketing providers and operators. Exactly one passenger per booking must be marked as the contact person using isContactPerson: true. The contact person must provide both email and tel so they can receive operational updates.

Notes:

• Only one passenger should be marked as contact person per booking
• When isContactPerson is true, email and tel must be provided
• Other fields may be required depending on operator (see PassengerRequirements)

Selection of fare for a journey

Selection of offer for a journey

Selection for a booking

Filter for journey search results by journey type.

Use this to restrict which journey variants are returned. Supported types:

• SMART: Comfort-optimized journeys; may split long routes across days. Default journey type returned by the API.
• BLUEPRINT: Journeys based on predefined itinerary blueprints (curated or editorial routes), can include planned stopovers.
• NON_STOP: Fastest end-to-end journeys without planned overnight stopovers.

You can combine multiple types to retrieve several variants at once.

Filter for filtering pass bundles by various criteria.

Supported filters:

• product: Filter by specific pass product type, e.g. "interrail-global-pass"
• class: Filter by travel class (e.g. "1stclass" or "2ndclass")
• campaignCode: Filter by promotional campaign code, e.g. "INTERRAIL_2025"

Use this to narrow down pass bundle results when searching for available passes.

Place property to update

Ancillary to add to a booking for a given passenger

Ancillary selection to remove from a booking