Smart Search

Smart Search (smartSearch.do) will be deprecated soon.

Do not use it for new integrations. Use search.do where possible.

Smart Search(Only For TMC)

post

Advantages of Smart Search:

• Supports real-time search for booking windows and routes not covered in "Search API".

• Enhances search result rate and overall coverage.

Points to note:

• Smart Search will be activated "on demand". Please contact your account manager or sales director if you want this feature to be activated.

• The ist response will return the results from the cache. if the "smartEnd"=false, send the subsequent requests until if the "smartEnd"=true to get all the results from the LIVE search.

• Use production endpoint being used for APls other than search APl.

Workflow:

• Send the "Smart Search" request(called First Request) and receive the response, which includes an ID (requestId) used to identify the entire search process, and may also contain part of the flight data(routings).

• After receiving the response, if thesmartEnd=false, then send another request (called Subsequent Request) only with therequestId.

• Follow this flow untilsmartEnd=true. This means that the smart search has been completed.

Endpoint: https://sandbox.atriptech.com/smartSearch.do

Header parameters

AcceptstringRequiredExample: application/json

Content-TypestringRequiredExample: application/json

Accept-EncodingstringRequiredExample: gzip

x-atlas-client-idstringRequiredExample: <YOUR_CLIENT_ID>

x-atlas-client-secretstringRequiredExample: <YOUR_CLIENT_SECRET>

Body

application/json

requestIdstringRequired

Only required in Subsequent Request

tripTypestring · enumRequired

The trip type(1=one way or 2=round trip) you want to search

Example: 1Possible values:

adultNuminteger · min: 1 · max: 9Required

Adult passenger count. Please note that the total number of adults(adultNum) and children(childNum) cannot exceed 9.

Default: 0Example: 1

childNuminteger · max: 8Required

Child passenger count. Please note that the total number of adults(adultNum) and children(childNum) cannot exceed 9

Default: 0Example: 0

infantNuminteger · max: 9Required

Infant passenger count, no more than the number of adult

Default: 0Example: 0

fromCitystringRequired

IATA code of the departure city or airport (in capital letters).When the airport code you sent is different from the code of the city where the airport is located, we can recognize that it is an airport, otherwise we will treat it as a city code. We will filter flights based on your departure location type.

Example: LON

toCitystringRequired

IATA code of the arrival city or airport (in capital letters).When the airport code you sent is different from the code of the city where the airport is located, we can recognize that it is an airport, otherwise we will treat it as a city code. We will filter flights based on your departure location type.

Example: PAR

fromAirportstring · nullableOptional

IATA code of the departure airport

Example: AAA

toAirportstring · nullableOptional

IATA code of the arrival airport

Example: AAA

fromDatestring · dateRequired

Departure date, the format is YYYYMMDD

Example: 20251010

retDatestring · date · nullableOptional

Return date, the format is YYYYMMDD. If you are searching for round-trip, the return date is mandatory.

airlinesstring[] · nullableOptional

An array of IATA Codes(in capital letters) of airlines. The result will only contain the airlines specified in the search request.

fromFlightNumbersstring[] · nullableOptional

Search for specified departure flights. Each element represents one flight. Connecting flight numbers are separated by "," (comma). Example:

• ["FR123"]: A direct flight
• ["FR456,FR789"]: A connecting flight
• ["FR123", "FR456,FR789"]: 2 flights, a direct flight and a connecting flight

retFlightNumbersstring[] · nullableOptional

Search for specified return flights. Each element represents one flight. Connecting flight numbers are separated by "," (comma).

includeMultipleFareFamilyboolean · nullableOptional

Search only for the lowest fare or for the Fare Families. By default, each flight only returns the lowest fare, and each array element in the response represents: flight - lowest fare. If this parameter is turned on, each element of the search results will be a combination of flight and one of the fares, that is, different elements will have the same flight but different ticket fare.

Default: false

currencystring · nullableOptional

This is the settlement currency. The 3-letter currency code should be entered. This field is optional, and when you want to settle with Atlas in different currencies (especially when you have opened multiple deposit accounts in different currencies in Atlas), you need to use this parameter.

displayCurrencystring · nullableOptional

The currency for the display fares in response. If no display currency is specified, the display amount will be null.

requestSourcestring · nullableOptional

Identify the source of the search traffic, E.g. Google Flights, Oganic Search, SkyScanner.

syncbooleanOptional

Is smart search synchronized return, default is asynchronous

residentCodestring · nullableOptional

Resident discount code

Responses

200Success

application/json

post

/smartSearch.do

HTTPcURLJavaScriptPython

POST /smartSearch.do HTTP/1.1
Accept: text
Accept-Encoding: text
x-atlas-client-id: text
x-atlas-client-secret: text
Content-Type: application/json
Content-Length: 223

{
  "adultNum": 2,
  "childNum": 0,
  "currency": "GBP",
  "fromCity": "ACE",
  "fromDate": "20250920",
  "includeMultipleFareFamily": false,
  "infantNum": 0,
  "maxResponseTime": 15000,
  "requestSource": "Dynamic",
  "sync": true,
  "toCity": "LON",
  "tripType": "1"
}

200Success

{
  "status": 0,
  "requestId": "17553346623104JGpo",
  "smartEnd": true,
  "routings": [
    {
      "adultDetails": [
        {
          "amount": 12.09,
          "code": "farePrice",
          "description": "",
          "type": "base"
        },
        {
          "amount": 76.07,
          "code": "tax",
          "description": "",
          "type": "tax"
        }
      ],
      "adultPrice": 12.09,
      "adultTax": 76.07,
      "ancillaryProductElements": [
        {
          "ancillaryCode": "SCI_BAG_3PC_66KG",
          "auxBaggageElement": {
            "allWeight": true,
            "piece": 3,
            "size": "",
            "weight": 66
          },
          "canPurchasePostTicket": 0,
          "canPurchaseWithTicket": 1,
          "categoryCode": "StandardCheckInBaggage",
          "clientTechnicalServiceFee": 0,
          "currency": "GBP",
          "maxQty": 1,
          "minQty": 1,
          "price": 134.56,
          "productCode": "SCI_BAG_3PC_66KG",
          "segmentIndex": 1,
          "vendorCurrency": "GBP",
          "vendorPrice": 133.57
        },
        {
          "ancillaryCode": "SCI_BAG_1PC_22KG",
          "auxBaggageElement": {
            "allWeight": true,
            "piece": 1,
            "size": "",
            "weight": 22
          },
          "canPurchasePostTicket": 0,
          "canPurchaseWithTicket": 1,
          "categoryCode": "StandardCheckInBaggage",
          "clientTechnicalServiceFee": 0,
          "currency": "GBP",
          "maxQty": 1,
          "minQty": 1,
          "price": 44.86,
          "productCode": "SCI_BAG_1PC_22KG",
          "segmentIndex": 1,
          "vendorCurrency": "GBP",
          "vendorPrice": 44.53
        },
        {
          "ancillaryCode": "SCI_BAG_2PC_44KG",
          "auxBaggageElement": {
            "allWeight": true,
            "piece": 2,
            "size": "",
            "weight": 44
          },
          "canPurchasePostTicket": 0,
          "canPurchaseWithTicket": 1,
          "categoryCode": "StandardCheckInBaggage",
          "clientTechnicalServiceFee": 0,
          "currency": "GBP",
          "maxQty": 1,
          "minQty": 1,
          "price": 89.71,
          "productCode": "SCI_BAG_2PC_44KG",
          "segmentIndex": 1,
          "vendorCurrency": "GBP",
          "vendorPrice": 89.05
        }
      ],
      "ancillarySupported": [
        "seat",
        "luggage"
      ],
      "bundleOptions": [],
      "childDetails": [
        {
          "amount": 12.09,
          "code": "farePrice",
          "description": "",
          "type": "base"
        },
        {
          "amount": 76.07,
          "code": "tax",
          "description": "",
          "type": "tax"
        }
      ],
      "childPrice": 12.09,
      "childTax": 76.07,
      "combineIndexs": [],
      "currency": "GBP",
      "expireTime": "2025-08-16T12:19:38Z",
      "fid": "z8NUOiqt5NX05yUOdg0-RfZls9ockAhaJJ6w56FfZVEKQtULkxLefdhdb239v6gV",
      "fromSegments": [
        {
          "aircraftCode": "",
          "arrAirport": "STN",
          "arrTerminal": "",
          "arrTime": "202509210155",
          "cabin": "",
          "cabinClass": 1,
          "carrier": "LS",
          "codeShare": false,
          "depAirport": "ACE",
          "depTerminal": "",
          "depTime": "202509202150",
          "duration": 245,
          "fareFamily": "low",
          "flightNumber": "LS1422",
          "operatingCarrier": "",
          "operatingFlightnumber": "",
          "seatCount": 2,
          "segmentIndex": 1,
          "stopCities": ""
        }
      ],
      "infantAllowed": true,
      "infantDetails": [
        {
          "amount": 25.19,
          "code": "farePrice",
          "description": "",
          "type": "base"
        },
        {
          "amount": 0,
          "code": "tax",
          "description": "",
          "type": "tax"
        }
      ],
      "infantPrice": 25.19,
      "infantTax": 0,
      "nationality": "",
      "nationalityType": 0,
      "paxType": "ADT",
      "refreshTime": "2025-08-16T03:30:38Z",
      "retSegments": [],
      "riskSellout": false,
      "routingIdentifier": "QUNFX0xPTl8xXzIwMjUwOTIwX18yXzBfMHxYSEc3MjczMV9hcGlfMXwxfDg4LjE2Xzg4LjE2XzI1LjE5XzAuNjVfMjAyLjE2X0dCUHxBQ0VfTE9OXzFfMjAyNTA5MjBfXzJfMF8wXkFDRS1MUzE0MjItLVNUTi0yMDI1MDkyMDIxNTAtMjAyNTA5MjEwMTU1LWxvdy0xLV44OC4xNl84OC4xNl8yNS4xOV8wLjY1XzIwMi4xNl5BTFNBUElfQUxTXl5BTFMxQUNFTE9OMjAwMjAyNTA5MjBeR0JQXjg3LjUwXjg3LjUwXjI1LjAwXjF8MXwyMDI1MDgxNjE2NTc1NnwwfDE3NTUzMzQ2NjIzMTA0Skdwb3x8fHx8MS4zMHw0fDB8R0JQfG5vcm1hbHxmYWxzZQ==.Q86tmtSTKhG8cbOGw3SsCJVxdMAfHLwnafWbeP2Sjw4=",
      "rule": {
        "baggageElements": [
          {
            "baggagePiece": 0,
            "baggageSize": "",
            "baggageType": "StandardCheckInBaggage",
            "baggageWeight": 0,
            "passengerType": 0,
            "segmentNo": 1
          },
          {
            "baggagePiece": 0,
            "baggageSize": "",
            "baggageType": "StandardCheckInBaggage",
            "baggageWeight": 0,
            "passengerType": 1,
            "segmentNo": 1
          },
          {
            "baggagePiece": 0,
            "baggageSize": "",
            "baggageType": "StandardCheckInBaggage",
            "baggageWeight": 0,
            "passengerType": 2,
            "segmentNo": 1
          },
          {
            "baggagePiece": 1,
            "baggageSize": "56*45*25cm",
            "baggageType": "CabinBaggageOverheadLocker",
            "baggageWeight": 10,
            "passengerType": 0,
            "segmentNo": 1
          },
          {
            "baggagePiece": 1,
            "baggageSize": "56*45*25cm",
            "baggageType": "CabinBaggageOverheadLocker",
            "baggageWeight": 10,
            "passengerType": 1,
            "segmentNo": 1
          },
          {
            "baggagePiece": 0,
            "baggageSize": "56*45*25cm",
            "baggageType": "CabinBaggageOverheadLocker",
            "baggageWeight": 0,
            "passengerType": 2,
            "segmentNo": 1
          }
        ],
        "changesRules": [
          {
            "changesFee": 0,
            "changesStatus": "T",
            "changesType": 0,
            "currency": "GBP",
            "revNoShowCondition": 0,
            "revNoshow": "T",
            "revNoshowFee": 0,
            "ruleDetailList": [
              {
                "amount": 75.5,
                "currency": "GBP",
                "endMinute": 300,
                "ruleId": 38876,
                "startMinute": 525600,
                "status": "H"
              },
              {
                "amount": 0,
                "currency": "GBP",
                "endMinute": 0,
                "ruleId": 38877,
                "startMinute": 300,
                "status": "T"
              },
              {
                "amount": 0,
                "currency": "GBP",
                "endMinute": -525600,
                "ruleId": 38878,
                "startMinute": 0,
                "status": "T"
              }
            ]
          }
        ],
        "hasBaggage": 1,
        "refundRules": [
          {
            "currency": "GBP",
            "refNoShowCondition": 0,
            "refNoshow": "T",
            "refNoshowFee": 0,
            "refundFee": 0,
            "refundMethod": "CASH_BACK_TO_ORIGINAL_PAYMENT",
            "refundStatus": "T",
            "refundType": 0,
            "ruleDetailList": [
              {
                "amount": 0,
                "currency": "GBP",
                "endMinute": 0,
                "refundMethod": "CashBackToOriginalPayment",
                "ruleId": 31451,
                "startMinute": 525600,
                "status": "T"
              },
              {
                "amount": 0,
                "currency": "GBP",
                "endMinute": -525600,
                "refundMethod": "CashBackToOriginalPayment",
                "ruleId": 31452,
                "startMinute": 0,
                "status": "T"
              }
            ]
          }
        ],
        "serviceElements": [
          {
            "hasFreeMeal": 0,
            "hasFreeSeat": 0
          }
        ]
      },
      "separateBookings": false,
      "suitAge": "",
      "supportCreditTransPayment": "1",
      "supportPaymentMethods": [
        1,
        3
      ],
      "transactionFee": 1.3,
      "transactionFeeMode": "PER_BOOKING",
      "transactionFeePerPax": 0.65,
      "vendorFare": {
        "vendorAdultPrice": 12,
        "vendorAdultTax": 75.5,
        "vendorChildPrice": 12,
        "vendorChildTax": 75.5,
        "vendorCurrency": "GBP",
        "vendorInfantPrice": 25,
        "vendorInfantTax": 0
      }
    }
  ]
}