Ryanair Requirements

For customers that choose to use Ryanair (FR) content via Universal API:

Provisioning / Credentials

No agency provisioning with the carrier.

Ryanair UK Limited

On January 25, 2024, Travelport supports Ryanair UK Limited flights within the Ryanair API. Ryanair UK is a subsidiary of low-cost carrier group Ryanair Holdings, with flight operations commencing in March 2019. This is not a separate adapter. Therefore, this comes with the following limitations:

Itinerary / Passenger Type support

ACH Supports the following Itinerary types for Ryanair :

Ryanair currently returns Direct/Non-Stop segments but does not return:

Ryanair does not have any code-shares with other network carriers; however during peak seasons, they do induct wet leased aircraft in their network for more than 60 days at a time. This causes those flights to be required to be noted as code shares (operated by a different carrier) per U.S. Department of Transportation regulations.

An enhancement is being introduced in Jan 2017 that blocks shopping for any Spanish Domestic itineraries from any Point of Sale. If a user searches using FareShop or Carrier Specific Availability, no Spanish Domestic routes will return. If a user searches using Neutral Availability, Spanish Domestic routes will return; however an error will return if those segments are selected in the booking process.

Passenger Types

The following passenger types are supported by Ryanair:

Passenger Type PTC Age Restrictions
Adult

ADT

No age validation for ADT

Child

CHD 2 - 16 years

Infant

INF lesser than or equal to 1 years, 11 months, 30 days

Window Shopping

Ryanair supports window shopping (search widening). Ryanair allows for a search expanded to 7 days total.

Cabins, Fares, and Fare Families

ACH will return the lowest fare options.

Cabins

Ryanair supports a single cabin class.

Fares Returned

Taxes and Fees

GDS Fee

Currency Code GDS Fee

CHF

3.50

CZK 90.00

90.00
DKK 24.00
EUR 3.00
GBP 3.00
HUF 1050.00
MAD 36.00
NOK 30.00
PLN 15.00
SEK 33.00
USD 4.00

VAT Tax (Value Added Tax)

A value-added tax, known in some countries as a goods and services tax, is a type of tax that is assessed incrementally. It is levied on the price of a product or service at each stage of production, distribution, or sale to the end consumer. This tax applies to the GDS fee and also ancillary services for domestic travel in the countries listed below.

VAT Tax Country Tax Code Percentage
Bulgaria BG 20%

Greece

EL 1 3/24% VAT rate is either 13% or 24% depending on time of travel

Spain

ES 2-10% VAT rate varies and can be anything between 2% and 10% depending on the route

Italy

FN 10%

Morocco

HH 1 4% Not yet in Production as of 10/31/2023

Poland

PO 8%

Romania

RZ

18%

France

UI 10%

Portugal

WB 6%

Sweden

XS

6%

German

ZG

19%

Fare Families

RyanAir supports and uses the following fare families:

Plus (formerly LeisurePlus)

Notes:

<Errors>

<Error RecordID="NNSFR:Ryanair" Type="922" ShortText="The carrier does not support multiple booking class in an itinerary">The requested itinerary or fare combination is not supported by the carrier</Error>

</Errors>

FlexiPlus (formerly BusinessPlus)

Note: Below error returns if Plus fare is combined with any other fare besides another Plus fare.

<Errors>

<Error RecordID="NNSFR:Ryanair" Type="922" ShortText="The carrier does not support multiple booking class in an itinerary">The requested itinerary or fare combination is not supported by the carrier</Error>

</Errors>

FlexiPlus Fare Booking Rules

The following rules need to be followed while creating bookings on ACH:

Regular

Basic Fare

Fare Family Use

RBD (Reservations/Booking Designator) Mapping

Fare Family Mapped RBD Ryanair Product Class
Basic Y R
Regular

G

G

Plus

L L

FlexiPlus

B B

Multiple Class Bookings

M, N and T are excluded/blocked to the Travelport Universal API.

Private / Negotiated / Corporate Fares

Ryanair does not support private, negotiated or corporate fare modifiers. However they have discounted fares.

Passenger and Contact Details

Passenger Details

Ryanair requires the following information from all passengers as mandatory data to create a booking.

Note: Ryanair returns passenger's NamePrefix, FirstName, MiddleName, and Surname in the API response. However, they do not use the MiddleName while displaying the passenger details in FR official website. Because Ryanair is not using the passenger's middle name (except for Spanish domestic flights, which is not supported through ACH), the Ryanair itinerary may reflect the name information in this order: Title, First Name, Last Name, Middle Name. It is correct in the API request and response, and in the Ryanair system. For example, Name added through Universal API

Prefix="Ms" First="JANE" Middle="LEOKADIA" Last="DOE"

On the Ryanair Website:

Ms JANE DOE LEOKADIA

Passenger Information Description Data Field Restriction
NamePrefix Required Mr, Ms, Mrs, Miss, Mstr, Master only

GivenName(as on passport)

Required ONLY accepts alphabet (A-Za-z), CANNOT accepts numeric and special character

Surname (as on passport)

Required ONLY accepts alphabet (A-Za-z), CANNOT accepts numeric and special character
BirthDate for Infant only Required  

PhoneNumber (lead passenger home number only)

Required

FR only accept a single home phone

MobileNumber

Required  

Email (lead passenger only)

Required  

Resident Country (for insurance only but currently out of scope as of Jan 2014)

Optional  

Passenger Titles

ACH Ryanair adapter supports the Standard ACH Passenger Name Prefixes.

Below are the expected request and response titles:

Request Title Response Title

Mr

MR
Ms

MS

Miss

MS

Mrs

MRS

Mstr

CHD

Master

CHD

The adapter also supports the following additional name prefixes:

Code Description
MR

MR

MS

MS

MRS

MRS
MISS

MS

Contact Details

The Ryanair Air API supports the following contact information:

For the Lead Passenger

For all other passengers

Travel Agency/Booker Contact Details

The Ryanair Air API supports the following contact information for Travel Agency/Booker (Type=T in BookingContact):

Note: Ryanair has indicated this information is mandatory, however, there is no validation on the carrier side. If missing, the booking can still be created and the information will not be sent to Ryanair for the Travel Agency/Booker Contact.

For the *Lead Passenger Only*

Required Passenger Information

Ryanair does not support collecting Secure Flight and APIS information through Universal API. Only supported during web check-in.

Frequent Flyer Support

Ryanair does not have a frequent flyer program and they do not support any other carrier’s frequent flyer programs. If frequent flyer information is sent in the ACH request it will not be forwarded on to the carrier.

Currency and Fulfillment Support

Currency Support

Ryanair supports the following currencies:

Currency Code Currency Name

CHF

SWISS FRANC
CZK

CZECH KORUNA

DKK

DANISH KRONE

EUR

EURO

GBP

BRITISH POUND

HUF

HUNGARIAN FORINT
MAD MOROCCAN DIRHAM

NOK

NORWEGIAN KRONE

PLN

POLLISH ZLOTY

SEK

SWEDISH KRONA
USD US DOLLAR

Ryan Air permits currency override for all itineraries as long as the requested currency is on the Ryanair supported currencies list. If an ACH request is sent with a currency override of a currency other than that on the supported currencies list, ACH will return the following warning in the ACH response and the shop results will be returned in the currency of the origin airport.

<Warning RecordID="NNSFR : ACH Ryanair Adapter" ShortText="The requested currency is not supported by the adapter" Type="739">Invalid currency code.</Warning>

Country Currency Overrides

For the following countries Ryanair does not support the default national currency, and the following overrides apply for itineraries originating in the countries.

Country National Currency Overridden Currency

RO - Romainia

RON - Romanian leu EUR - Euro

HR - Croatia

HRK - Croatian Kuna EUR - Euro

BG - Bulgaria

BGN - Bulgarian Lev EUR - Euro

If a user decides to use another currency other than EUR to replace the RON or HRK or BGN currencies, he/she may do so as long as it is a currency on the supported currencies list.

Fulfillment Support

Supported Forms of payment: Credit / Debit Cards

Credit / Debit Card Payments

The following cards are supported:

Note: No credit or debit card fee is applied at time of booking.

Card Code Card Name CVV/CID

AX

American Express Yes

VI

Visa Yes

VI

Visa Connect Debit Yes

MC

MasterCard

Yes

MC

MasterCard Debit Yes

DL

Visa Delta Debit Yes

VE

Visa Electron Debit Yes

DM

Mastercard Debit Yes

DS

Discover Yes

DN

Diner's Club Yes
TP Universal Air Travel Card

No

Payment Required Fields

The use of multiple credit cards and forms of payment are not applicable.

Optional Services and Fees

Optional Services

This section documents the optional services and fees supported by the carrier. Ryanair supports the Optional Services listed below.

Bags

Following are the baggage rules imposed by Ryanair that will be applied by ACH:

ACH applies the following rules:

Validation error: "Only 3 bags per passenger, per segment are allowed by the carrier"

From 1st November 2018 Ryanair has introduced a new 10kg check-in baggage policy. The following are the 10kg rules imposed by Ryanair that will be applied by ACH:

Bag Tables

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

BAGW

BGPP20 AdditionalOption Baggage, 20kg BBG Yes BBG Passenger Segment 3 per passenger segment
BAGW BG__20FR AdditionalOption Baggage, 20kg BBBG Yes BBBG Passenger Segment 1 per passenger segment

BAGW

BGPP10

AdditionalOption

Baggage, 10kg

CBAG Yes CBAG Passenger Segment 1 per passenger segment

Baby Equipment

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

BAGW

BGIN

AdditionalOption Infant Baggage, Baby Equip BABY Yes BABY Passenger Segment 3 per passenger Segment

Sports Equipment

Following are the Sport Equipment rules imposed by Ryanair that will be applied by ACH:

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

SPEQ

BGSP

AdditionalOption

Sports Equipment SPRT Yes SPRT Passenger Segment 2 per passenger Segment

SPEQ

BGSPLG AdditionalOption Sports Equipment, Large BULK Yes BULK Passenger Segment 2 per passenger Segment

SPEQ

BGSPSK AdditionalOption Sports Equipment, Ski SKI Yes SKI Passenger Segment 2 per passenger Segment

SPEQ

BGMI

AdditionalOption

Musical Instruments MUSC Yes MUSC Passenger Segment 1 per passenger Segment

SPEQ

BGSPGF

AdditionalOption

GolfEquipment GOLF Yes GOLF Passenger Segment 2 per Passenger Segment

SPEQ

BGSPBI

AdditionalOption

Bike

BIKE

Yes BIKE Passenger Segment 2 per Passenger Segment

Priority Boarding

Starting in Q2 2016, Ryanair is offering Priority Boarding as a stand-alone option for purchase. Following are the Priority Boarding rules imposed by Ryanair that will be applied by ACH:

Example of warning if priority boarding as a stand-alone option is not selected for all passengers/segments: <Warning RecordID="NNSFR:ACH Ryanair Adapter" Type="908" ShortText="Purchase of Priority Boarding will apply to all passengers and all segments in booking."

Note: Priority Boarding will no longer be included for free with the purchase of a Premium seat.

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

SPEEDBRD

TSPR

AdditionalOption

Priority Boarding and 2 Cabin Bags

PS No PS Passenger Segment 1 per Passenger Segment

SPEEDBRD

TSPFFR FreeOption Priority Boarding and 2 Cabin Bags PF No PF Passenger Segment 1 per Passenger Segment

Airport Check In

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

APC

TSCIAT AdditionalOption Airport Checkin AACI No   1 per passenger segment 1 per passenger segment
AACI TSCIFR FreeOption Airport Checkin AACI No   1 per passenger Segment 1 per passenger Segment

Fast track airport security

As of Q3 2016, Fast Track airport security is being offered by Ryanair as a standalone option available for purchase. FAST will continue to be included as a free option with FlexiPlus fares.

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

FAST

TSSYPT FreeOption Fast Track FAST No 1 per passenger Segment 1 per passenger Segment

Seats

ACH Code ATPCO Option Code Mapping

Option Type

Description

Vendor Option Code

Secondary Code Required

Secondary Code

Name
Applicability

Application Limits

SEAT

SA Additional Option Standard Seat 2 Yes 2 Passenger Segment 1 per passenger segment

SEAT SA__

PR Additional Option Priority Seat 1 Yes 1 Passenger Segment 1 per passenger segment

SEAT

SABH Additional Option Priority with extra leg room Seat 3 Yes 3 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z1 Additional Option Standard Seat 4 Yes 4 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z2 Additional Option Standard Seat 5 Yes 5 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z3 Additional Option Standard Seat 6 Yes 6 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z4 Additional Option Standard Seat 7 Yes 7 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z5 Additional Option Standard Seat 8 Yes 8 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z6

Additional Option

Standard Seat

9

Yes

9 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z7 Additional Option Standard Seat 10 Yes 10 Passenger Segment 1 per passenger segment

SEAT SA__

X0Z8 Additional Option Standard Seat 11 Yes 11 Passenger Segment 1 per passenger segment

Non Chargable SSRs - special service requests

Only available options in the price response can be booked.

SSR Code Description

AACI *

Complimentary Boarding Pass Issue

BDGR *

Travelling with Service Animal-Travel with guide/ assistance dog (PRM SEAT)

BLDP *

Blind/vision impaired – requires no assistance

BLND

Blind/vision impaired - walker required (PRM SEAT)

DEAF

DEAF- Profoundly deaf - separate safety briefing

DPNA

Intellectual disability - walker required(PRM seat)

LEGL

Left leg in full cast

LEGR

Right leg in full cast

OXYG

Oxygen Requested (PRM SEAT)

PETC

Animal in Cabin-Travel with assistance dog (PRM SEAT)

SMI *

Medical Equipment-Special Medical Item

WCHR

Assistance required to/from boarding gate

WCHS

Assistance through apt and up/down steps (PRM SEAT)

WCLB

Lithium battery wheelchair/scooter

WCAP *

Requires an airport wheelchair

WCBD

Dry/Gel Cell battery wheelchair/scooter

WCHC

Assistance to seat inc. lift on/off (PRM seat)

WCMP

Using own manual wheelchair

* Indicates which SSR is not industry standard.

Internationalization Support

Multiple languages are support for Ryanair in ACH is based on ACH Internationalization Specification. The carrier supports the following languages:

Primary Language Code Variants Supported

Default Variant

Name

ca

ca-ES (Rest ignored) ca-ES Catalan; Valencian

da

da-DK (Rest ignored) da-DK Danish

de

de-DE (Rest ignored) de-DE German

el

el-GR (Rest ignored) el-GR Greek

en

en-IE, en-GB, en-US (Rest ignored) en-IE English

es

es-ES (Rest ignored) es-ES Spanish; Castilian

fr

fr-FR (Rest ignored) fr-FR French

hu

hu-HU (Rest ignored) hu-HU Hungarian

it

it-IT (Rest ignored) it-IT Italian

lt

lt-LT (Rest ignored) lt-LT Lithuanian
nb nb-NO (Rest ignored) nb-NO Norwegian Bokmål (Covered by macrolanguage no)

no

(All ignored) nb-NO Norwegian

nl

nl-NL (Rest ignored) nl-NL Dutch

pl

pl-PL (Rest ignored) pl-PL Polish

pt

pt-PT (Rest ignored) pt-PT Portuguese

sv

sv-SE (Rest ignored) sv-SE Swedish