Skip to main content
POST
/
flight
/
fare
/
validate
Validate Fare & Lock Price
curl --request POST \
  --url https://api.travomatrix.com/api/v1/flight/fare/validate \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "search_id": "SEARCH_123",
  "signature": "SIG_XYZ",
  "pax": {
    "adult": 1
  }
}
'
{
  "fare_token": "<string>",
  "offer": {
    "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"
  }
}

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.

Fare validation performs a live check with the airline provider (GDS/NDC) and creates a guaranteed price lock for 15 minutes. Upon successful validation, you will receive a fare_token, which is required for creating a booking and exploring ancillaries like seats and meals.

Authorizations

​
X-API-Key
string
header
required

Headers

​
X-Request-ID
string

Unique correlation ID for tracing.

Body

application/json
​
search_id
string
required
​
signature
string
required
​
pax
object

Response

200 - application/json

Price lock created for 15 minutes.

​
fare_token
string
​
status
enum<string>
Available options:
VALID,
PRICE_CHANGED,
SOLD_OUT,
FARE_EXPIRED,
PROVIDER_ERROR
​
offer
object