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.

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