Skip to main content
POST
/
flight
/
search
Search Flights
curl --request POST \
  --url https://api.travomatrix.com/api/v1/flight/search \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "origin": "DEL",
  "dest": "BOM",
  "dod": "20270515",
  "pax_adult": 1,
  "mode": "b2b"
}
'
{
  "search_id": "<string>",
  "results": [
    {
      "offer_id": "<string>",
      "search_id": "<string>",
      "signature": "<string>",
      "airline": "<string>",
      "segments": [
        {
          "carrier": "<string>",
          "flight_no": "<string>",
          "origin": "<string>",
          "dest": "<string>",
          "dep_time": "2023-11-07T05:31:56Z",
          "arr_time": "2023-11-07T05:31:56Z",
          "booking_class": "<string>",
          "seats_available": 123
        }
      ],
      "best_price_paise": 123,
      "currency": "<string>",
      "pricing_breakdown": {
        "base_fare": 123,
        "taxes": 123,
        "commission": 123,
        "ota_markup": 123,
        "agent_markup": 123,
        "net_fare": 123,
        "final_price": 123
      },
      "expires_at": "2023-11-07T05:31:56Z"
    }
  ],
  "cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.travomatrix.com/llms.txt

Use this file to discover all available pages before exploring further.

Welcome to Scenario 1: Simple One-Way. This certification step requires you to search for a flight for 1 Adult. Because we are using a focused interactive widget here, you won’t see the massive API schema on this page—just what you need to test!

​
Request Setup

​
origin
string
default:"DEL"
3-letter IATA origin code.
​
dest
string
default:"BOM"
3-letter IATA destination code.
​
dod
string
default:"20270515"
Departure Date (YYYYMMDD).
​
pax_adult
integer
default:"1"
Number of adults.

​
Instructions

  1. Look at the right panel. The request is natively embedded and pre-filled with the exact test payload above.
  2. Hit the Send button to fire the request to UAT.
  3. Review the PricingBreakdown in the response payload on the right.
Requirement: Copy the search_id and the signature from the response body. You will need them in the next step.

Authorizations

​
X-API-Key
string
header
required

Headers

​
X-Request-ID
string

Unique correlation ID for tracing.

Body

application/json
​
origin
string
required
Pattern: ^[A-Z]{3}$
Example:

"DEL"

​
dest
string
required
Pattern: ^[A-Z]{3}$
Example:

"DXB"

​
dod
string
required

Departure date in YYYYMMDD format.

Pattern: ^\d{8}$
Example:

"20270501"

​
doa
string

Return date in YYYYMMDD format (optional for one-way).

Pattern: ^\d{8}$
Example:

"20270505"

​
pax_adult
integer
default:1
Required range: 1 <= x <= 9
​
pax_child
integer
default:0
Required range: 0 <= x <= 9
​
pax_infant
integer
default:0
Required range: 0 <= x <= 9
​
cabin
enum<string>
Available options:
ECONOMY,
PREMIUM_ECONOMY,
BUSINESS,
FIRST
​
limit
integer
default:100
​
cursor
string

Pagination cursor obtained from the previous search response.

Response

List of flight offers.

​
search_id
string
​
results
object[]
​
cursor
string