Official Api

Search Flight - Filter

POST

https://test-api.ucuzyolu.com/flight/filter

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

journeyId

string

required

filters

object

required

travelTime.departureTime

string

required

Example

{
  "journeyId": "{{journeyId}}",
  "filters": {
    "travelTime.departureTime": "gece"
  }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://test-api.ucuzyolu.com/flight/filter' \
--header 'client-id: 302382-1928283273-237723829-292999' \
--header 'Content-Type: application/json' \
--data-raw '{
    "journeyId": "",
    "filters": {
        "travelTime.departureTime": "gece"
    }
}'

Responses

🟢200OK

application/json

Body

data

array[object (FlightItem) {44}]

required

searchId

string

required

flightId

string

required

journeyId

string

required

flightNumber

string

required

isTransit

boolean

required

isDomestic

boolean

required

duration

string <time>

required

airDuration

string <time>

required

waitDuration

string <time>

required

seatsAvailable

integer

required

segments

array[object (FlightSegment) {31}]

required

informationTexts

array [object {2}]

required

paxItems

array[object (FlightPaxItem) {16}]

required

alternativePrices

array[object (FlightServicePriceItem) {36}]

required

stops

integer

required

combinations

array[object (FlightItem) {44}]

required

serviceFee

integer

required

serviceFeeOriginal

integer

required

serviceFeeDiscount

integer

required

tax

number

required

taxDiscount

integer

required

netFare

number

required

totalFare

number

required

currency

string

required

priceIncludesRoundPrice

boolean

required

ourFare

number

required

totalPrice

number

required

departureDate

string

required

departureTime

string

required

departureDateTime

string

required

arrivalDate

string

required

arrivalTime

string

required

arrivalDateTime

string

required

airlineLabel

string

required

airlineMarketing

string

required

airlineOperating

string

required

providerSearchId

string

required

providerId

string

optional

providerName

string

optional

bookingProviderId

null

optional

bookingProviderCode

null

optional

cabin

string

required

cabinClass

string

required

documentRequires

array[object (FlightDocumentRequires) {4}]

required

success

boolean

required

code

integer

required

message

string

required

Example

{
  "data": [
    {
      "searchId": "22BAD856-2FF6-45DD-A162-1F1D87D0F28E",
      "flightId": "49fc9fc1-be17-43d7-bcaa-903b3bb90814",
      "journeyId": "sT09UGtBNotLs2GCGzfEBIUf1YGt9grkVpAi",
      "flightNumber": "TK2658",
      "isTransit": false,
      "isDomestic": true,
      "duration": "01:30",
      "airDuration": "01:30",
      "waitDuration": "00:00",
      "seatsAvailable": 9,
      "segments": [
        {
          "segmentId": "c3416970-7b42-4b07-a793-a434955caefe",
          "flightNumber": "TK2658",
          "type": "arrival",
          "sequenceNo": 1,
          "airplaneCode": null,
          "airplaneName": "A320-200",
          "duration": "01:30",
          "cabinClass": "economy",
          "cabin": "O",
          "seatsAvailable": 9,
          "originAirport": "Atatürk Havalimanı",
          "originAirportCode": "IST",
          "originCity": "Istanbul",
          "originCityCode": "IST",
          "originCountry": "Turkey",
          "originCountryCode": "TR",
          "destinationAirport": "Nuri Demirağ Havalimanı",
          "destinationAirportCode": "VAS",
          "destinationCity": "Sivas",
          "destinationCityCode": "VAS",
          "destinationCountry": "Turkey",
          "destinationCountryCode": "TR",
          "departureDate": "2024-12-10",
          "departureTime": "09:25",
          "departureDateTime": "2024-12-10 09:25",
          "arrivalDate": "2024-12-10",
          "arrivalTime": "10:55",
          "arrivalDateTime": "2024-12-10 10:55",
          "airlineLabel": "Turkish Airlines",
          "airlineMarketing": "TK",
          "airlineOperating": "TK",
          "airlineIcon": "http://api.tripingram.local/uploads/TK.png"
        }
      ],
      "paxItems": [
        {
          "paxId": "b06dbab9-1864-4c7a-81cd-2c8274a6b569",
          "serviceId": "2A972486-51DF-4DCE-8C43-1CED92D6EE68",
          "paxCode": "ADT",
          "sequence": 1,
          "freeBaggage": [
            {
              "value": 15,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1432.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1435.19,
          "baseFare": 1171.61,
          "needsRefresh": false
        }
      ],
      "alternativePrices": [
        {
          "serviceId": "2A972486-51DF-4DCE-8C43-1CED92D6EE68",
          "paxId": "b06dbab9-1864-4c7a-81cd-2c8274a6b569",
          "fareType": "EF",
          "fareBasisCode": "OEF",
          "paxCode": "ADT",
          "paxSequence": 1,
          "isPromo": false,
          "businessLounge": false,
          "seatSelection": false,
          "isSelected": true,
          "brandCode": "EF",
          "brandKey": "EFTK21",
          "brandName": "ECOFLY",
          "freeBaggage": [
            {
              "value": 15,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            },
            {
              "value": 8,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "carry"
            }
          ],
          "bonus": null,
          "meal": null,
          "cancellationPolicies": [],
          "changePolicies": [],
          "informationTexts": [
            {
              "code": "baggage",
              "text": "15 KG Bagaj"
            },
            {
              "code": "baggage",
              "text": "8 KG Kabin Bagajı"
            },
            {
              "code": "meal",
              "text": "Ücretsiz yemek ikramı."
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1432.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1435.19,
          "baseFare": 1171.61,
          "needsRefresh": false,
          "cabin": "O",
          "cabinClass": "economy"
        },
        {
          "serviceId": "567BB79D-71BE-44C7-B39A-8B1A46E05786",
          "paxId": "b06dbab9-1864-4c7a-81cd-2c8274a6b569",
          "fareType": "XF",
          "fareBasisCode": "OXF",
          "paxCode": "ADT",
          "paxSequence": 1,
          "isPromo": false,
          "businessLounge": false,
          "seatSelection": true,
          "isSelected": false,
          "brandCode": "XF",
          "brandKey": "XFTK64",
          "brandName": "EXTRAFLY",
          "freeBaggage": [
            {
              "value": 20,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            },
            {
              "value": 8,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "carry"
            }
          ],
          "bonus": null,
          "meal": null,
          "cancellationPolicies": [],
          "changePolicies": [],
          "informationTexts": [
            {
              "code": "baggage",
              "text": "20 KG Bagaj"
            },
            {
              "code": "baggage",
              "text": "8 KG Kabin Bagajı"
            },
            {
              "code": "meal",
              "text": "Ücretsiz yemek ikramı."
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1757.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1760.19,
          "baseFare": 1496.61,
          "needsRefresh": false,
          "cabin": "O",
          "cabinClass": "economy"
        },
        {
          "serviceId": "050AE0C7-F577-44C0-9952-65462E3AACD2",
          "paxId": "b06dbab9-1864-4c7a-81cd-2c8274a6b569",
          "fareType": "PF",
          "fareBasisCode": "OPF",
          "paxCode": "ADT",
          "paxSequence": 1,
          "isPromo": false,
          "businessLounge": false,
          "seatSelection": true,
          "isSelected": false,
          "brandCode": "PF",
          "brandKey": "PFTK62",
          "brandName": "PRIMEFLY",
          "freeBaggage": [
            {
              "value": 25,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            },
            {
              "value": 8,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "carry"
            }
          ],
          "bonus": null,
          "meal": null,
          "cancellationPolicies": [],
          "changePolicies": [],
          "informationTexts": [
            {
              "code": "baggage",
              "text": "25 KG Bagaj"
            },
            {
              "code": "baggage",
              "text": "8 KG Kabin Bagajı"
            },
            {
              "code": "changepolicy",
              "text": "1 saate kadar kesintisiz iade."
            },
            {
              "code": "cancellationpolicy",
              "text": "12 saate kadar kesintisiz iade."
            },
            {
              "code": "meal",
              "text": "Ücretsiz yemek ikramı."
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1812.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1815.19,
          "baseFare": 1551.61,
          "needsRefresh": false,
          "cabin": "O",
          "cabinClass": "economy"
        }
      ],
      "stops": 0,
      "combinations": [],
      "documentRequires": [],
      "informationTexts": [],
      "isPacked": false,
      "serviceFee": 3,
      "serviceFeeOriginal": 3,
      "serviceFeeDiscount": 0,
      "tax": 257.58,
      "taxDiscount": 0,
      "netFare": 1432.19,
      "totalFare": 1432.19,
      "currency": "TRY",
      "priceIncludesRoundPrice": false,
      "vqFare": 0,
      "yrFare": 0,
      "ourFare": 3,
      "totalPrice": 1435.19,
      "baseFare": 1171.61,
      "needsRefresh": false,
      "departureDate": "2024-12-10",
      "departureTime": "09:25",
      "departureDateTime": "2024-12-10 09:25",
      "arrivalDate": "2024-12-10",
      "arrivalTime": "10:55",
      "arrivalDateTime": "2024-12-10 10:55",
      "airlineLabel": "Turkish Airlines",
      "airlineMarketing": "TK",
      "airlineOperating": "TK",
      "airlineIcon": null,
      "providerSearchId": "def54efe-a93e-48f8-abfa-873c07d194a1",
      "providerId": "biletbank",
      "bookingProviderId": null,
      "bookingProviderCode": null,
      "cabin": "O",
      "cabinClass": "economy"
    },
    {
      "searchId": "22BAD856-2FF6-45DD-A162-1F1D87D0F28E",
      "flightId": "0d4967f0-0ec2-4b21-ac21-c4911ab0de59",
      "journeyId": "sT09UGtBNotLs2GCGzfEBIUf1YGt9grkVpAi",
      "flightNumber": "TK2660",
      "isTransit": false,
      "isDomestic": true,
      "duration": "01:30",
      "airDuration": "01:30",
      "waitDuration": "00:00",
      "seatsAvailable": 9,
      "segments": [
        {
          "segmentId": "56c550a4-af3f-473d-b188-3222d817c537",
          "flightNumber": "TK2660",
          "type": "arrival",
          "sequenceNo": 1,
          "airplaneCode": null,
          "airplaneName": "A320-200",
          "duration": "01:30",
          "cabinClass": "economy",
          "cabin": "O",
          "seatsAvailable": 9,
          "originAirport": "Atatürk Havalimanı",
          "originAirportCode": "IST",
          "originCity": "Istanbul",
          "originCityCode": "IST",
          "originCountry": "Turkey",
          "originCountryCode": "TR",
          "destinationAirport": "Nuri Demirağ Havalimanı",
          "destinationAirportCode": "VAS",
          "destinationCity": "Sivas",
          "destinationCityCode": "VAS",
          "destinationCountry": "Turkey",
          "destinationCountryCode": "TR",
          "departureDate": "2024-12-10",
          "departureTime": "18:40",
          "departureDateTime": "2024-12-10 18:40",
          "arrivalDate": "2024-12-10",
          "arrivalTime": "20:10",
          "arrivalDateTime": "2024-12-10 20:10",
          "airlineLabel": "Turkish Airlines",
          "airlineMarketing": "TK",
          "airlineOperating": "TK",
          "airlineIcon": "http://api.tripingram.local/uploads/TK.png"
        }
      ],
      "paxItems": [
        {
          "paxId": "d6cd21b9-6720-4ad0-84d3-b45fbe01c1d2",
          "serviceId": "E40D58A7-27C5-4CCF-ACEF-F98DE093306A",
          "paxCode": "ADT",
          "sequence": 1,
          "freeBaggage": [
            {
              "value": 15,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1432.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1435.19,
          "baseFare": 1171.61,
          "needsRefresh": false
        }
      ],
      "alternativePrices": [
        {
          "serviceId": "E40D58A7-27C5-4CCF-ACEF-F98DE093306A",
          "paxId": "d6cd21b9-6720-4ad0-84d3-b45fbe01c1d2",
          "fareType": "EF",
          "fareBasisCode": "OEF",
          "paxCode": "ADT",
          "paxSequence": 1,
          "isPromo": false,
          "businessLounge": false,
          "seatSelection": false,
          "isSelected": true,
          "brandCode": "EF",
          "brandKey": "EFTK21",
          "brandName": "ECOFLY",
          "freeBaggage": [
            {
              "value": 15,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            },
            {
              "value": 8,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "carry"
            }
          ],
          "bonus": null,
          "meal": null,
          "cancellationPolicies": [],
          "changePolicies": [],
          "informationTexts": [
            {
              "code": "baggage",
              "text": "15 KG Bagaj"
            },
            {
              "code": "baggage",
              "text": "8 KG Kabin Bagajı"
            },
            {
              "code": "meal",
              "text": "Ücretsiz yemek ikramı."
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1432.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1435.19,
          "baseFare": 1171.61,
          "needsRefresh": false,
          "cabin": "O",
          "cabinClass": "economy"
        },
        {
          "serviceId": "C736488B-651C-45AA-BA2B-641AEF8BFE2D",
          "paxId": "d6cd21b9-6720-4ad0-84d3-b45fbe01c1d2",
          "fareType": "XF",
          "fareBasisCode": "OXF",
          "paxCode": "ADT",
          "paxSequence": 1,
          "isPromo": false,
          "businessLounge": false,
          "seatSelection": true,
          "isSelected": false,
          "brandCode": "XF",
          "brandKey": "XFTK64",
          "brandName": "EXTRAFLY",
          "freeBaggage": [
            {
              "value": 20,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            },
            {
              "value": 8,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "carry"
            }
          ],
          "bonus": null,
          "meal": null,
          "cancellationPolicies": [],
          "changePolicies": [],
          "informationTexts": [
            {
              "code": "baggage",
              "text": "20 KG Bagaj"
            },
            {
              "code": "baggage",
              "text": "8 KG Kabin Bagajı"
            },
            {
              "code": "meal",
              "text": "Ücretsiz yemek ikramı."
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1757.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1760.19,
          "baseFare": 1496.61,
          "needsRefresh": false,
          "cabin": "O",
          "cabinClass": "economy"
        },
        {
          "serviceId": "66E1279E-E073-4C87-84BF-A775C76B3937",
          "paxId": "d6cd21b9-6720-4ad0-84d3-b45fbe01c1d2",
          "fareType": "PF",
          "fareBasisCode": "OPF",
          "paxCode": "ADT",
          "paxSequence": 1,
          "isPromo": false,
          "businessLounge": false,
          "seatSelection": true,
          "isSelected": false,
          "brandCode": "PF",
          "brandKey": "PFTK62",
          "brandName": "PRIMEFLY",
          "freeBaggage": [
            {
              "value": 25,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "weight"
            },
            {
              "value": 8,
              "paxCode": "ADT",
              "unit": "KG",
              "unitType": "carry"
            }
          ],
          "bonus": null,
          "meal": null,
          "cancellationPolicies": [],
          "changePolicies": [],
          "informationTexts": [
            {
              "code": "baggage",
              "text": "25 KG Bagaj"
            },
            {
              "code": "baggage",
              "text": "8 KG Kabin Bagajı"
            },
            {
              "code": "changepolicy",
              "text": "1 saate kadar kesintisiz iade."
            },
            {
              "code": "cancellationpolicy",
              "text": "12 saate kadar kesintisiz iade."
            },
            {
              "code": "meal",
              "text": "Ücretsiz yemek ikramı."
            }
          ],
          "serviceFee": 3,
          "serviceFeeOriginal": 3,
          "serviceFeeDiscount": 0,
          "tax": 257.58,
          "taxDiscount": 0,
          "netFare": 0,
          "totalFare": 1812.19,
          "currency": "TRY",
          "priceIncludesRoundPrice": false,
          "vqFare": 0,
          "yrFare": 0,
          "ourFare": 3,
          "totalPrice": 1815.19,
          "baseFare": 1551.61,
          "needsRefresh": false,
          "cabin": "O",
          "cabinClass": "economy"
        }
      ],
      "stops": 0,
      "combinations": [],
      "documentRequires": [],
      "informationTexts": [],
      "isPacked": false,
      "serviceFee": 3,
      "serviceFeeOriginal": 3,
      "serviceFeeDiscount": 0,
      "tax": 257.58,
      "taxDiscount": 0,
      "netFare": 1432.19,
      "totalFare": 1432.19,
      "currency": "TRY",
      "priceIncludesRoundPrice": false,
      "vqFare": 0,
      "yrFare": 0,
      "ourFare": 3,
      "totalPrice": 1435.19,
      "baseFare": 1171.61,
      "needsRefresh": false,
      "departureDate": "2024-12-10",
      "departureTime": "18:40",
      "departureDateTime": "2024-12-10 18:40",
      "arrivalDate": "2024-12-10",
      "arrivalTime": "20:10",
      "arrivalDateTime": "2024-12-10 20:10",
      "airlineLabel": "Turkish Airlines",
      "airlineMarketing": "TK",
      "airlineOperating": "TK",
      "airlineIcon": null,
      "providerSearchId": "def54efe-a93e-48f8-abfa-873c07d194a1",
      "providerId": "biletbank",
      "bookingProviderId": null,
      "bookingProviderCode": null,
      "cabin": "O",
      "cabinClass": "economy"
    }
  ],
  "success": true,
  "code": 0,
  "message": ""
}

Modified at 2024-11-28 01:29:13

Prebooking

Flight Alerts - Create