NDC Frequently Asked Question
Need help? Check FAQs?
What is NDC?
New Distribution Capability (NDC) is a travel industry-supported programme launched by IATA for the development and market adoption of a new, XML-based data transmission standard that enhances the capability of communications between airlines and travel agents. It enables the travel industry to transform the way air products are retailed to corporations, leisure, and business travellers by addressing the industry’s current distribution limitations: product differentiation and time-to-market, access to full and rich air content, and finally, a transparent shopping experience.
Will IndiGo provide the option to service the bookings such as exchange, split, and cancellation?
Yes, all servicing-related functionalities will be made available.
Is 6E NDC content now accessible?
6E NDC content is now available and accessible.
How can 6E NDC content be accessed?
The NDC content will be made available through IndiGo direct NDC APIs, GDSs, and non-GDS NDC aggregators.
What NDC schemas will IndiGo be using?
IndiGo supports IATA NDC schema version 21.3.5, ensuring alignment with modern airline retailing and industry standards.
How do I get started with 6E NDC Swagger Portal?
To get started with 6E NDC Swagger Portal, you will require to Login and Register. In case you need help,click here to find the process.
Will IndiGo offer all fare RBDs for domestic and international sectors on NDC?
Yes
What features will IndiGo NDC support?
Our NDC products can support fare families, ancillary services offered during booking and post booking, reissue, refund,and hold booking.
What type of content can be accessed using IndiGo NDC APIs?
You can access content for:
- Domestic Flights
- International Flights
- CodeShare Flights
What are the payment methods offered for Indigo NDC APIs?
- Agency
- Agency Credit (AGT)
- Industry Payment
- BSP Cash
- Credit Cards (Pass-through / Personal cards)
- American Express
- Diners
- Mastercard
- VISA
Who is eligible to access 6E NDC content?
See below for the list of NDC channels we offer, and the sellers authorized to access 6E NDC content.
| Channels | Eligible Sellers |
|---|---|
| Direct access |
|
| GDS |
|
| Non-GDS aggregators / Technology service providers | 6E authorized partners |
What message format is used for API communication?
All requests and responses follow XML messaging structure as per IATA NDC 21.3 schema.
What are the core APIs available in the 6E NDC suite?
Typical APIs include:
- AirShoppingRQ/RS – Flight search
- OfferPriceRQ/RS – Pricing confirmation
- OrderCreateRQ/RS – Booking creation
- OrderRetrieveRQ/RS – Fetch booking details
- OrderChangeRQ/RS – Modification
- OrderCancelRQ/RS – Cancellation
What protocol is used for secure communication?
- The NDC Gateway uses TLS 1.2
- All endpoints must be accessed over HTTPS
What authentication mechanism is required?
- Base64-encoded credentials are required for Authorization.
- Typically passed in the HTTP Authorization header.
- Uses Basic Authentication.
- Credentials are encoded in the format username:password.
Authorization: Basic <Base64Encoded(username:password)>
Is IP whitelisting mandatory?
- Yes, communication must be established via IP-to-IP connectivity.
- Partner public IP(s) must be shared and whitelisted by 6E before access is granted.
Are there additional security requirements?
- Strict adherence to secure transport (HTTPS).
- Compliance with API security policies (no credential exposure, encrypted payloads via TLS).
- Session/token handling must follow best practices.
Does the API support compression?
- Yes, API supports gzip and deflate compression.
- Compression is recommended for improved latency and bandwidth optimization.
Example:
Accept-Encoding: gzip, deflate
Best practices for performance?
- Use compression (gzip) to reduce payload size and improve response times.
- Minimize redundant API calls wherever possible.
- Cache static and reference data to reduce unnecessary requests.
- Handle retries using appropriate backoff strategies.
- Avoid long-running synchronous calls to improve application responsiveness.
What are the key integration requirements?
Developers must comply with:
- IATA-compliant XML schema structure
- Proper NDC workflow orchestration (Shop → Price → Book → Service)
- API security standards (TLS, Base64 Auth, IP Whitelisting)
Is there a standard workflow to follow?
Yes (recommended flow):
1. AirShoppingRQ → Fetch offers
2. OfferPriceRQ → Validate pricing
3. OrderCreateRQ → Create booking
4. OrderRetrieveRQ → Confirm order
1. AirShoppingRQ → Fetch offers
2. OfferPriceRQ → Validate pricing
3. OrderCreateRQ → Create booking
4. OrderRetrieveRQ → Confirm order
What type of errors should integrators handle?
Integrators should handle:
- Business errors (e.g., fare expired, seat unavailable)
- Technical errors (timeouts, gateway failures)
- Validation errors (schema mismatch)
Is certification mandatory before production access?
Yes.
- Certification is mandatory for all partners.
What does certification involve?
Certification involves:
- Execution of designated test cases
- Covering end-to-end flows:
- Search
- Pricing
- Booking
- Post-booking scenarios
How are test results submitted?
Please share the test results with the 6E NDC Support Team at:
• 6ENDC.SUP@goIndiGo.in
• Ensure API logs are included, along with complete request and response payloads.
• 6ENDC.SUP@goIndiGo.in
• Ensure API logs are included, along with complete request and response payloads.
What happens after successful certification?
• Formal approval is granted.
• Partner is enabled for Production environment access.
• Partner is enabled for Production environment access.
Is Solution Design Document required?
Yes.
• A 6E Partner NDC Solution Design Document is mandatory.
• Required for:
o Technical alignment
o Architecture validation
o Integration approval
• A 6E Partner NDC Solution Design Document is mandatory.
• Required for:
o Technical alignment
o Architecture validation
o Integration approval
What should the Solution Design Document include?
• System architecture diagram
• API integration flow
• Authentication & security design
• Error handling strategy
• Performance considerations
• API integration flow
• Authentication & security design
• Error handling strategy
• Performance considerations
What environments are available?
• Test/UAT Environment (for certification)
• Production Environment (post certification)
• Production Environment (post certification)
Can partners access production directly?
No.
• Production access is granted only after successful certification and approval.
• Production access is granted only after successful certification and approval.
How to raise issues during integration?
• Reach out to the 6E NDC Support Team at 6ENDC.SUP@goIndiGo.in
• Provide:
o API logs
o Request/Response XML
o Timestamp and environment details
• Provide:
o API logs
o Request/Response XML
o Timestamp and environment details
Are change requests allowed during integration?
• Yes, but must be reviewed.
• Any deviation from standard schema/workflow requires approval.
• Any deviation from standard schema/workflow requires approval.
What are common mistakes to avoid?
• Incorrect XML schema usage
• Skipping OfferPrice step before booking
• Not enabling compression
• Missing IP whitelisting
• Incorrect Base64 encoding credentials
• Skipping OfferPrice step before booking
• Not enabling compression
• Missing IP whitelisting
• Incorrect Base64 encoding credentials
How can developers access API documentation?
API documentation is shared via:
• Partner-specific Developer Portal / Documentation links
• XML schema (XSD files) for NDC 21.3.5
• Integration guides provided during onboarding
• Partner-specific Developer Portal / Documentation links
• XML schema (XSD files) for NDC 21.3.5
• Integration guides provided during onboarding
What is typically available in the Developer Portal?
• API documentation (XML-based)
• Sample request/response payloads
• Schema definitions (XSDs)
• Test cases for certification
• Error codes and handling guidelines
• Why am I unable to access API/Portal URL?
• Sample request/response payloads
• Schema definitions (XSDs)
• Test cases for certification
• Error codes and handling guidelines
• Why am I unable to access API/Portal URL?
Why am I unable to access API/Portal URL?
• IP not whitelisted
• Incorrect credentials
• TLS not configured properly
• Access restricted to specific VPN/network
• Incorrect credentials
• TLS not configured properly
• Access restricted to specific VPN/network
How to identify OfferIDs for Round-Trip bookings?
Step-by-step approach:
1. Identify onward and return travel dates in AirShoppingRS.
2. Find corresponding SegmentID.
3. Map SegmentID → PaxJourneyID.
4. Search PaxJourneyID → extract:
o OfferID
o OfferItemID
• This approach also applies to Multi-city bookings.
1. Identify onward and return travel dates in AirShoppingRS.
2. Find corresponding SegmentID.
3. Map SegmentID → PaxJourneyID.
4. Search PaxJourneyID → extract:
o OfferID
o OfferItemID
• This approach also applies to Multi-city bookings.
How to identify connecting flights?
Look for PaxJourneyID with multiple SegmentRefIDs.
• More than 1 segment indicates a connecting flight.
• More than 1 segment indicates a connecting flight.
How to identify “Via flights”?
Check:
<DatedOperatingSegment>
<DatedOperatingLegRefID>...</DatedOperatingLegRefID>
<DatedOperatingLegRefID>...</DatedOperatingLegRefID>
</DatedOperatingSegment>
• Same segment with multiple legs indicates a Via flight.
What is the standard booking flow?
1. Auth (Access Token)
2. AirShopping
3. Seat/SSR Availability
4. OfferPrice
5. OrderCreate (Payment mandatory)
6. OrderRetrieve
2. AirShopping
3. Seat/SSR Availability
4. OfferPrice
5. OrderCreate (Payment mandatory)
6. OrderRetrieve
Can bookings be put on Hold?
• Yes, hold bookings are supported, subject to the applicable business agreement.
How to generate Base64 credentials?
Format:
<Domain>\<AgentID>:<Password>
Example:
WWW\XNDXXXXNXX:Abc@54321
<Domain>\<AgentID>:<Password>
Example:
WWW\XNDXXXXNXX:Abc@54321
Why is authentication failing?
Ensure:
• Prefix with "Basic "
• Correct Base64 encoding
• Valid subscription key
• Prefix with "Basic "
• Correct Base64 encoding
• Valid subscription key
Can authentication tokens be reused?
Yes, within validity (~30 mins OR as per configuration).
• Use the same token in the Authorization header.
• Use the same token in the Authorization header.
Mandatory headers?
• Authorization
• Ocp-apim-subscription-key
• Content-Type
• Accept-Encoding
• Ocp-apim-subscription-key
• Content-Type
• Accept-Encoding
IP whitelisting limits
• A maximum of 5 IPs (combined for Test & Production environments) is allowed.
How to check seat availability?
Look for:
XML
<OccupationStatusCode>F</OccupationStatusCode>
• F = Free
XML
<OccupationStatusCode>F</OccupationStatusCode>
• F = Free
Seat type codes
• L = Leg space
• W = Window
• A = Aisle
• I = Infant
• W = Window
• A = Aisle
• I = Infant
Can we get seats & SSR in AirShopping?
• No
• Use separate APIs:
• Use separate APIs:
| Feature | API |
|---|---|
| Seat Availability | /SeatAvailability |
| SSR Pre-booking | /Selling/ServiceList |
| SSR Post-booking | /Servicing/ServiceList |
Can SSR be modified after booking?
• Modify/Delete not supported
• Only addition allowed
• Only addition allowed
Is PaymentFunctions mandatory?
• Yes (critical requirement)
• OfferPrice → define FOP
• OrderCreate → complete payment
• OfferPrice → define FOP
• OrderCreate → complete payment
Is overpayment/underpayment allowed?
• No — payment amount must match the quoted price exactly.
Are refunds supported?
• Yes
o Please refer API Guide
o Please refer API Guide
Mandatory passenger details
• First Name
• Last Name
• DOB
• Gender
• PaxRefID
• Title
• Phone Number
• ETC (Refer Booking Guide for more)
• Last Name
• DOB
• Gender
• PaxRefID
• Title
• Phone Number
• ETC (Refer Booking Guide for more)
Infant handling
• Infants are defined under Passenger Type Code INFX (TBD)
• Infant handling is not supported via SSR
• Infant handling is not supported via SSR
Max passengers per booking
• Up to 9 (ADT + CHD)
• Up to 4 INF
• Up to 4 INF
Identity documents supported
• Passport (PT) only
Can we filter AirShopping by Flight No?
• Not supported
Can we limit AirShopping results?
• Not supported
Cabin type codes
• 2 = Business (Stretch)
• 5 = Economy
• 5 = Economy
Special fare types
• Not supported
How to identify fare type?
• Use PriceClassID
Seat unavailable error
• Seat may already be booked
• Always re-fetch SeatAvailability
• Always re-fetch SeatAvailability
500 errors in post-booking SSR
• Use correct endpoint /Servicing/ServiceList
What is the status of the baggage discrepancy and other current limitations?
• The baggage discrepancy is a known issue at the host system level.
• Similar inconsistencies may occur in related workflows due to existing system limitations.
• Resolution is currently in progress and will be addressed in an upcoming fix.
• Similar inconsistencies may occur in related workflows due to existing system limitations.
• Resolution is currently in progress and will be addressed in an upcoming fix.
Can I underpay or overpay on my bookings?
• No, underpayment or overpayment is not allowed.
• Payments must be completed for the exact amount specified in the OfferPrice response (OfferPrice RS).
• Payments must be completed for the exact amount specified in the OfferPrice response (OfferPrice RS).