Official Api
1.0.0
  • latest
  • 1.0.0
  1. One Way / 1 ADT
Official Api
1.0.0
  • latest
  • 1.0.0
  • Auth
    • Login/Guest Login
      • Auth - Guest
      • Auth - Login
      • Auth - Login (With E-Mail)
    • Register
      • Auth - Register
      • Auth - Register Corporate
    • Remember
      • Auth - Remember Password
      • Auth - Remember Otp Verify
      • Auth - Set New Password
    • Auth Otp Verify
      POST
    • Auth - Logout
      DELETE
    • Auth - State
      GET
  • Customer
    • Passengers
      • Passenger List
      • Passenger Create
      • Passenger Delete
      • Passenger Update
    • invoice Info
      • Invoice Info - List
      • Invoice Info - Create
      • Invoice Info - Delete
      • Invoice Info - Update
    • Favorite Flights
      • Favorites - Flight
      • Favorites - Add Flight
      • Favorites - Delete Flight
      • Favorites - Check for Flight
    • Notifications
      • Notifications - Get
      • Notifications - Update
      • Notifications - Register Device
      • Notifications - Unregister Device
    • Fast Actions
      • Fast Actions - Get Flight Actions
      • Fast Actions - Update Flight Actions
      • Fast Actions - Get Bus Actions
      • Fast Actions - Update Bus Actions
      • Fast Actions - Clear Flight Actions
    • Customer - Get Profile
      GET
    • Customer - Update Profile
      POST
    • Customer - Update Password
      POST
    • Search History - Flight
      GET
    • Customer - Remove Account
      DELETE
  • Utils
    • Calendar - Month
    • Enums - FlightSearchFilters
  • Flight
    • Search
      • Domestic
        • One Way / 1 ADT
          • Search Flight
          • Get Job (Flight)
          • Calculate Package Price
          • Allocate
          • Set Passengers
          • Prebooking
        • Round Trip / 1 ADT
          • Search Flight
          • Get Job (Flight)
          • Calculate Price
          • Allocate
          • Set Passengers
          • Prebooking
        • Round Trip / 2 ADT
          • Search Flight
          • Get Job (Flight)
          • Calculate Price
          • Allocate
          • Set Passengers
          • Prebooking
        • Round Trip / 1 ADT (Non package)
          • Search Flight
          • Get Job (Flight)
          • Allocate
          • Set Passengers
          • Prebooking
      • International
        • One Way / 1 ADT
          • Search Flight
            POST
          • Get Job (Flight)
            GET
          • Allocate
            POST
          • Set Passengers
            POST
          • Prebooking
            POST
          • Payment Types
            GET
        • Round Trip / 1 ADT
          • Search Flight
          • Get Job (Flight)
          • Allocate
          • Set Passengers
          • Prebooking
        • Round Trip / 2 ADT
          • Search Flight
          • Get Job (Flight)
          • Calculate Price Copy
          • Allocate
          • Set Passengers
          • Prebooking
      • Search Flight - Filter
        POST
    • Price Alerts
      • Flight Alerts - Create
      • Flight Alerts - List
      • Flight Alerts - Delete
      • Flight Alerts - Create/Delete
    • Load Journey (dev only)
      GET
  • Bus
    • Bus - Search
    • Get Job (Bus)
    • Bus - Bus Details
    • Bus - Check Seat Status
    • Bus - Set Passengers
    • Bus - Finalize (Local Dev Only)
    • Bus - Search - Filter
  • Hotel
    • Hotel - Search by Destination
    • Hotel - Search by Hotel Code
    • Get Job (Hotel)
    • Hotel - Get Hotel Details
    • Hotel - Validate Rooms
    • Hotel - Set Paxes
    • Hotel - Complete (Dev Only)
  • Socket
  • Auto Completes
    • Airport Search
    • Bus Station Search
    • Hotel Search
  • Queue / Socket
    • Get Job
  • Misc
    • Airlines
    • Countries
    • Popular Cities
    • Currencies
    • Contact Form
    • Check Module Availability
    • Popular Flights
  • Payment
    • Pay with Account Balance (For Corporate Customers)
      • Payment - Account - Check Availablity
      • Payment - Account - Make Payment
    • Credit Card Storage
      • Saved Cards - List
      • Saved Cards - Add
      • Saved Cards - Delete
    • Pay with Credit Card (New Card)
      • Payment Types - Get All
      • Card Payment - Bin Query
      • Card Payment - Prepare 3D Form (new card)
      • Card Payment - Check Status
    • Pay with Credit Card (Saved Card)
      • Payment Types - Get All
      • Saved Cards - List
      • Card Payment - Bin Query
      • Card Payment - Prepare 3D Form (new card)
      • Card Payment - Check Status
  • Orders
    • Get Orders
    • Get Order
    • Upcoming Travels
    • Check Pnr
    • Check Order Status
  • Blog
    • Blog - Custom Tags
    • Blog - Category
    • Blog - Newest
  • Contents
    • Kampanyalar
    • Contact Information
    • Gizlilik Sözleşmesi
  • Refund
    • Flight Refund (Query)
    • Flight Refund (Complete)
  • Notifications
    • Notification List
    • Notification - Mark as Read
  • Otp Verify
    POST
  1. One Way / 1 ADT

Search Flight

Testing Env
https://test-api.ucuzyolu.com
Testing Env
https://test-api.ucuzyolu.com
POST
https://test-api.ucuzyolu.com
/flight/search

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
client-id
string 
optional
Default:
302382-1928283273-237723829-292999
Body Params application/json
searchType
enum<string> 
required
Allowed values:
onewayroundtrip
cabinClass
enum<string> 
required
Allowed values:
economyfirstbusinesscomfort
adt
integer 
required
Yetişkin
chd
integer 
optional
Çocuk
inf
integer 
optional
Bebek
mil
integer 
optional
Askeri Personel
direct
boolean 
required
yalnızca direkt uçuşlar
s
array[object (Search Flight Origin) {6}] 
required
Uçuş segmentleri
origin
string 
required
originIsCity
boolean 
required
Default:
false
destination
string 
required
destinationIsCity
boolean 
required
Default:
false
date
string <date>
required
Example:
2024-12-30
returnDate
string <date>
optional
Gidiş dönüş uçuş seçilmişse dönüş tarihi
Example:
2024-12-31
Example
{
    "searchType": "oneway",
    "cabinClass": "Economy",
    "adt": 1,
    "direct": false,
    "s": [
        {
            "origin": "IST",
            "originIsCity": true,
            "destination": "ESB",
            "destinationIsCity": false,
            "date": "2024-09-26"
        }
    ]
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://test-api.ucuzyolu.com/flight/search' \
--header 'client-id: 302382-1928283273-237723829-292999' \
--header 'Content-Type: application/json' \
--data-raw '{
    "searchType": "oneway",
    "cabinClass": "Economy",
    "adt": 1,
    "direct": false,
    "s": [
        {
            "origin": "IST",
            "originIsCity": true,
            "destination": "ESB",
            "destinationIsCity": false,
            "date": "2024-09-26"
        }
    ]
}'

Responses

🟢200OK
application/json
Body
data
object 
required
jobId
string 
required
status
string 
required
attempts
integer 
required
payload
object (FlightSearchResponse) 
optional
success
boolean 
required
code
integer 
required
message
string 
required
Example
{
    "data": {
        "jobId": "string",
        "status": "string",
        "attempts": 0,
        "payload": {
            "isSuccess": true,
            "isFavorited": true,
            "errorMessage": "string",
            "success": true,
            "isDomestic": true,
            "currency": "TRY",
            "action": "string",
            "flightType": "oneway",
            "status": "string",
            "bookingStatus": "pending",
            "searchStatus": "string",
            "journeyId": "string",
            "filters": [
                {
                    "name": "string",
                    "alias": "string",
                    "type": "base",
                    "attributes": [
                        {
                            "name": "string",
                            "alias": "string",
                            "value": "string",
                            "isSelected": true
                        }
                    ],
                    "filters": [
                        {}
                    ],
                    "min": 0,
                    "max": 0
                }
            ],
            "results": [
                {
                    "searchId": "string",
                    "flightId": "string",
                    "journeyId": "string",
                    "flightNumber": "string",
                    "isTransit": true,
                    "isDomestic": true,
                    "duration": "14:15:22Z",
                    "airDuration": "14:15:22Z",
                    "waitDuration": "14:15:22Z",
                    "seatsAvailable": 0,
                    "segments": [
                        {
                            "segmentId": "string",
                            "flightNumber": "string",
                            "type": "string",
                            "sequenceNo": 0,
                            "airplaneCode": "string",
                            "airplaneName": "string",
                            "duration": "14:15:22Z",
                            "cabinClass": "string",
                            "cabin": "s",
                            "seatsAvailable": 0,
                            "originAirport": "string",
                            "originAirportCode": "string",
                            "originCity": "string",
                            "originCityCode": "string",
                            "originCountry": "string",
                            "originCountryCode": "string",
                            "destinationAirport": "string",
                            "destinationAirportCode": "string",
                            "destinationCity": "string",
                            "destinationCityCode": "string",
                            "destinationCountry": "string",
                            "destinationCountryCode": "string",
                            "departureDate": "string",
                            "departureTime": "string",
                            "departureDateTime": "string",
                            "arrivalDate": "string",
                            "arrivalTime": "string",
                            "arrivalDateTime": "string",
                            "airlineLabel": "string",
                            "airlineMarketing": "string",
                            "airlineOperating": "string"
                        }
                    ],
                    "informationTexts": [
                        {
                            "code": "string",
                            "text": "string"
                        }
                    ],
                    "paxItems": [
                        {
                            "paxId": "string",
                            "serviceId": "string",
                            "paxCode": "ADT",
                            "sequence": 0,
                            "freeBaggage": [
                                {
                                    "value": 0,
                                    "paxCode": "string",
                                    "unit": "string",
                                    "unitType": "string"
                                }
                            ],
                            "serviceFee": 0,
                            "serviceFeeOriginal": 0,
                            "serviceFeeDiscount": 0,
                            "tax": 0,
                            "taxDiscount": 0,
                            "netFare": 0,
                            "totalFare": 0,
                            "currency": "string",
                            "priceIncludesRoundPrice": true,
                            "ourFare": 0,
                            "totalPrice": 0
                        }
                    ],
                    "alternativePrices": [
                        {
                            "serviceId": "string",
                            "paxId": "string",
                            "fareType": "string",
                            "fareBasisCode": "string",
                            "paxCode": "string",
                            "paxSequence": 0,
                            "isPromo": true,
                            "businessLounge": true,
                            "seatSelection": true,
                            "isSelected": true,
                            "brandCode": "string",
                            "brandKey": "string",
                            "brandName": "string",
                            "freeBaggage": [
                                {
                                    "value": 0,
                                    "paxCode": "string",
                                    "unit": "string",
                                    "unitType": "string"
                                }
                            ],
                            "bonus": {
                                "available": true,
                                "amount": 0,
                                "airlineIcon": null
                            },
                            "meal": {
                                "mealCode": "string",
                                "mealName": "string",
                                "mealSubCode": "string",
                                "mealDescription": "string"
                            },
                            "cancellationPolicies": [
                                {
                                    "price": 0,
                                    "currency": "string",
                                    "dateFrom": "string",
                                    "dateTo": "string",
                                    "hoursBeforeFlight": 0,
                                    "isRefundable": true,
                                    "text": "string"
                                }
                            ],
                            "changePolicies": [
                                {
                                    "price": 0,
                                    "currency": "string",
                                    "dateFrom": "string",
                                    "dateTo": "string",
                                    "hoursBeforeFlight": 0,
                                    "isChangeable": true,
                                    "text": "string"
                                }
                            ],
                            "informationTexts": [
                                {
                                    "code": "string",
                                    "text": "string"
                                }
                            ],
                            "serviceFee": 0,
                            "serviceFeeOriginal": 0,
                            "serviceFeeDiscount": 0,
                            "tax": 0,
                            "taxDiscount": 0,
                            "netFare": 0,
                            "totalFare": 0,
                            "currency": "string",
                            "priceIncludesRoundPrice": true,
                            "vqFare": 0,
                            "yrFare": 0,
                            "ourFare": 0,
                            "totalPrice": 0,
                            "baseFare": 0,
                            "needsRefresh": true,
                            "cabin": "string",
                            "cabinClass": "string"
                        }
                    ],
                    "stops": 0,
                    "combinations": [
                        {}
                    ],
                    "serviceFee": 0,
                    "serviceFeeOriginal": 0,
                    "serviceFeeDiscount": 0,
                    "tax": 0,
                    "taxDiscount": 0,
                    "netFare": 0,
                    "totalFare": 0,
                    "currency": "string",
                    "priceIncludesRoundPrice": true,
                    "ourFare": 0,
                    "totalPrice": 0,
                    "departureDate": "string",
                    "departureTime": "string",
                    "departureDateTime": "string",
                    "arrivalDate": "string",
                    "arrivalTime": "string",
                    "arrivalDateTime": "string",
                    "airlineLabel": "string",
                    "airlineMarketing": "string",
                    "airlineOperating": "string",
                    "providerSearchId": "string",
                    "providerId": "string",
                    "providerName": "string",
                    "bookingProviderId": null,
                    "bookingProviderCode": null,
                    "cabin": "string",
                    "cabinClass": "string",
                    "documentRequires": [
                        {
                            "name": "string",
                            "description": "string",
                            "code": "string",
                            "required": true
                        }
                    ]
                }
            ],
            "bookingItems": [
                {
                    "searchId": "string",
                    "flightId": "string",
                    "journeyId": "string",
                    "flightNumber": "string",
                    "isTransit": true,
                    "isDomestic": true,
                    "duration": "14:15:22Z",
                    "airDuration": "14:15:22Z",
                    "waitDuration": "14:15:22Z",
                    "seatsAvailable": 0,
                    "segments": [
                        {
                            "segmentId": "string",
                            "flightNumber": "string",
                            "type": "string",
                            "sequenceNo": 0,
                            "airplaneCode": "string",
                            "airplaneName": "string",
                            "duration": "14:15:22Z",
                            "cabinClass": "string",
                            "cabin": "s",
                            "seatsAvailable": 0,
                            "originAirport": "string",
                            "originAirportCode": "string",
                            "originCity": "string",
                            "originCityCode": "string",
                            "originCountry": "string",
                            "originCountryCode": "string",
                            "destinationAirport": "string",
                            "destinationAirportCode": "string",
                            "destinationCity": "string",
                            "destinationCityCode": "string",
                            "destinationCountry": "string",
                            "destinationCountryCode": "string",
                            "departureDate": "string",
                            "departureTime": "string",
                            "departureDateTime": "string",
                            "arrivalDate": "string",
                            "arrivalTime": "string",
                            "arrivalDateTime": "string",
                            "airlineLabel": "string",
                            "airlineMarketing": "string",
                            "airlineOperating": "string"
                        }
                    ],
                    "informationTexts": [
                        {
                            "code": "string",
                            "text": "string"
                        }
                    ],
                    "paxItems": [
                        {
                            "paxId": "string",
                            "serviceId": "string",
                            "paxCode": "ADT",
                            "sequence": 0,
                            "freeBaggage": [
                                {
                                    "value": 0,
                                    "paxCode": "string",
                                    "unit": "string",
                                    "unitType": "string"
                                }
                            ],
                            "serviceFee": 0,
                            "serviceFeeOriginal": 0,
                            "serviceFeeDiscount": 0,
                            "tax": 0,
                            "taxDiscount": 0,
                            "netFare": 0,
                            "totalFare": 0,
                            "currency": "string",
                            "priceIncludesRoundPrice": true,
                            "ourFare": 0,
                            "totalPrice": 0
                        }
                    ],
                    "alternativePrices": [
                        {
                            "serviceId": "string",
                            "paxId": "string",
                            "fareType": "string",
                            "fareBasisCode": "string",
                            "paxCode": "string",
                            "paxSequence": 0,
                            "isPromo": true,
                            "businessLounge": true,
                            "seatSelection": true,
                            "isSelected": true,
                            "brandCode": "string",
                            "brandKey": "string",
                            "brandName": "string",
                            "freeBaggage": [
                                {
                                    "value": 0,
                                    "paxCode": "string",
                                    "unit": "string",
                                    "unitType": "string"
                                }
                            ],
                            "bonus": {
                                "available": true,
                                "amount": 0,
                                "airlineIcon": null
                            },
                            "meal": {
                                "mealCode": "string",
                                "mealName": "string",
                                "mealSubCode": "string",
                                "mealDescription": "string"
                            },
                            "cancellationPolicies": [
                                {
                                    "price": 0,
                                    "currency": "string",
                                    "dateFrom": "string",
                                    "dateTo": "string",
                                    "hoursBeforeFlight": 0,
                                    "isRefundable": true,
                                    "text": "string"
                                }
                            ],
                            "changePolicies": [
                                {
                                    "price": 0,
                                    "currency": "string",
                                    "dateFrom": "string",
                                    "dateTo": "string",
                                    "hoursBeforeFlight": 0,
                                    "isChangeable": true,
                                    "text": "string"
                                }
                            ],
                            "informationTexts": [
                                {
                                    "code": "string",
                                    "text": "string"
                                }
                            ],
                            "serviceFee": 0,
                            "serviceFeeOriginal": 0,
                            "serviceFeeDiscount": 0,
                            "tax": 0,
                            "taxDiscount": 0,
                            "netFare": 0,
                            "totalFare": 0,
                            "currency": "string",
                            "priceIncludesRoundPrice": true,
                            "vqFare": 0,
                            "yrFare": 0,
                            "ourFare": 0,
                            "totalPrice": 0,
                            "baseFare": 0,
                            "needsRefresh": true,
                            "cabin": "string",
                            "cabinClass": "string"
                        }
                    ],
                    "stops": 0,
                    "combinations": [
                        {}
                    ],
                    "serviceFee": 0,
                    "serviceFeeOriginal": 0,
                    "serviceFeeDiscount": 0,
                    "tax": 0,
                    "taxDiscount": 0,
                    "netFare": 0,
                    "totalFare": 0,
                    "currency": "string",
                    "priceIncludesRoundPrice": true,
                    "ourFare": 0,
                    "totalPrice": 0,
                    "departureDate": "string",
                    "departureTime": "string",
                    "departureDateTime": "string",
                    "arrivalDate": "string",
                    "arrivalTime": "string",
                    "arrivalDateTime": "string",
                    "airlineLabel": "string",
                    "airlineMarketing": "string",
                    "airlineOperating": "string",
                    "providerSearchId": "string",
                    "providerId": "string",
                    "providerName": "string",
                    "bookingProviderId": null,
                    "bookingProviderCode": null,
                    "cabin": "string",
                    "cabinClass": "string",
                    "documentRequires": [
                        {
                            "name": "string",
                            "description": "string",
                            "code": "string",
                            "required": true
                        }
                    ]
                }
            ],
            "relations": {},
            "sortOptions": [
                {
                    "name": "string",
                    "description": "string",
                    "field": "string",
                    "type": "string"
                }
            ]
        }
    },
    "success": true,
    "code": 0,
    "message": "string"
}
🟢200Success (Non-async)
Modified at 2024-11-28 01:29:13
Previous
Prebooking
Next
Get Job (Flight)
Built with