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>",
  "status": "VALID",
  "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",
        "cabin": "ECONOMY",
        "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"
  }
}
Ensure you set adult: 2 in your validation payload.

Request Setup

search_id
string
required
Paste the search_id from Step 1.
signature
string
required
Paste the signature from Step 1.
pax
object
required

Instructions

  1. Review the requirements and set up the request payload.
  2. Hit the Send button.
Requirement: Copy the fare_token and provider. The price is locked for 15 minutes.

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