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"
  }
}
Before you can book, you must lock the price. We’ve removed the bloated schema definitions from this view so you can focus solely on executing the step.

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. Paste the search_id and signature you copied from Step 1 into the fields above (or directly in the JSON on the right).
  2. Hit the Send button.
Requirement: The provider has now locked this price for 15 minutes. Copy the fare_token from the response. You will need it to create the booking.

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