Special Service Request API

The Special Service Request API allows you to retrieve detailed information about additional services available for flight bookings, including baggage options, meal preferences, seat selections, and other special services.

API Endpoint

POST /flight/special_service_request

Request Parameters

Parameter	Type	Required	Description
`trace_id`	string	No	Unique identifier for tracing the request
`token`	string	No	Encrypted token containing flight booking details
`client_referenceId`	string	Yes	Unique client reference identifier
`booking_id`	string	No	Booking identifier

Headers Required

Header	Value	Description
`client-id`	string	Your unique client ID
`client-secret`	string	Your client secret key
`Content-Type`	application/json	Request content type

Example Request

{
    "trace_id": "c8812945-36ab-481c-84e6-413aa438f511",
    "token": "OB1[TBO]BwVNdj4P3j1AoCZQ+gmNK+0thztrQjDuTcA1EcRvENizNi6mw8IvRZBZOqDgt/YWFDvPACpKpP+bpgDFD008yjJrNQeEpOnZrtlczEYT9nR83cHVMntQTtty+JmqCXEaRg5D1RMSeB/GBH+5dY9GTw2fU0pLFWNP3IYGrPc+l9yZnkPgDYeUGDRf/y+TfUG0EfJJ8okrz1riCLL0l6vPHqU1MV2TAM8mkMP5aol/99kxsW+9mtoRKhrCBauxjUTsf3fk8PG19+iPBpOf4BnwxzXUZNxqcFqmIyUO1t6B/idkmsgcsissXNTv/NK6JLs4U+u42/+uyj4fjg777M/xpNFtPEAAez6KEn7WBVDbNwjBT++tt+4KtmztAxfkg3UytbOafNlM6kWe+16Yv/X/1w6eiyRP49Iwj2KbuuL0dO9BaT9Ja953lFPimTFQ9pFThDP4b75AycDv+k24vDBKYc5XXx2uJfLPzQLMhFjARZT8izmSP995al2P59ZUdGIcWvhmUj6qGQ5ArfbC2QLtE4T9hyNvITSXdH9AfkDilNFXxtsMLDRctoN3xcL7waRxq8hwUQ9JxHmvkXykZKAmRFX7j5ciUg29+NOjLvU9mYisc5/1VH/G3FiYNhrVCpkZe/Yrj8EYYEXBghSixtFMxCKZDjjoGBd+KlquKsA4yWY=",
    "client_referenceId": "swg776774338278w"
}

Response Structure

Success Response (HTTP 200)

{
    "status": "SUCCESS",
    "status_code": "200",
    "message": "Special service details have been successfully retrieved.",
    "data": {
        "trace_id": "c8812945-36ab-481c-84e6-413aa438f511",
        "result": {
            "baggage": [...],
            "meal": [...],
            "seat": {...},
            "special_services": [...]
        }
    }
}

Response Field Descriptions

Root Level Fields

Field	Type	Description
`status`	string	Response status (SUCCESS/FAILED)
`status_code`	string	HTTP status code
`message`	string	Response message
`data`	object	Response data container

Data Object Fields

Field	Type	Description
`trace_id`	string	Request trace identifier
`result`	object	Contains all service options

Baggage Options

The baggage array contains available baggage options:

Field	Type	Description
`code`	string	Baggage option code (e.g., "XBPA", "NoBaggage")
`desc`	string	Description of baggage service
`airline_code`	string	IATA airline code
`flight_number`	string	Flight number
`weight`	integer	Baggage weight in kg
`way_type`	string	Journey type (FullJourney/OneWay)
`price`	integer	Price in specified currency
`currency`	string	Currency code (INR/USD)
`origin`	string	Origin airport code
`destination`	string	Destination airport code
`text`	string	Additional information

Meal Options

The meal array contains available meal options:

Field	Type	Description
`code`	string	Meal option code (e.g., "VGML", "NoMeal")
`desc`	string	Service description
`airline_code`	string	IATA airline code
`airline_desc`	string	Detailed meal description
`flight_number`	string	Flight number
`quantity`	integer	Number of meals
`way_type`	string	Journey type
`price`	integer	Price per meal
`currency`	string	Currency code
`origin`	string	Origin airport code
`destination`	string	Destination airport code

Seat Selection

The seat object contains seat maps organized by rows:

Field	Type	Description
`code`	string	Seat identifier (e.g., "1A", "NoSeat")
`desc`	string	Service description
`airline_code`	string	IATA airline code
`flight_number`	string	Flight number
`craft_type`	string	Aircraft type
`row_no`	string	Row number
`seat_no`	string	Seat letter
`seat_type`	string	Seat position (Window/Aisle/Middle)
`seat_way_type`	string	Journey type
`availability_type`	string	Availability status (Reserved/Available)
`compartment`	integer	Compartment number
`deck`	integer	Deck level
`price`	integer	Seat selection fee
`currency`	string	Currency code
`origin`	string	Origin airport code
`destination`	string	Destination airport code

Special Services

The special_services array contains additional services:

Field	Type	Description
`code`	string	Service code (e.g., "FFWD")
`desc`	string	Service description
`airline_code`	string	IATA airline code
`flight_number`	string	Flight number
`departure_time`	string	Flight departure time
`price`	integer	Service fee
`currency`	string	Currency code
`origin`	string	Origin airport code
`destination`	string	Destination airport code
`text`	string	Additional service details

Common Service Codes

Baggage Codes

NoBaggage: No additional baggage
XBPA: 5kg additional baggage
XBPB: 10kg additional baggage
XBPC: 15kg additional baggage
XBPD: 30kg additional baggage

Meal Codes

NoMeal: No meal selection
VGML: Vegetarian meal
CPML: Corporate meal plan
TCSW: Sandwich combo
CNWT: Cashew nuts
CJSW: Chicken sandwich combo

Special Service Codes

FFWD: Priority check-in service

Error Responses

Error Response Structure

{
    "status": "FAILED",
    "status_code": "400",
    "message": "Error description",
    "error_details": "Detailed error information"
}

Integration Notes

Token Handling: The token parameter contains encrypted flight details from previous flight search/booking steps
Pricing: All prices are in the specified currency (typically INR for domestic flights)
Availability: Seat availability is real-time and may change between requests
Service Combinations: Multiple services can be selected and combined for a single booking