flight_compare
Compare current flight offers with deterministic price, duration, stop and available reliability signals.
When to use
Use when an agent needs flight compare from current travel offers.
Selection guidance
Role: supporting. Use when an agent needs flight compare from current travel offers.
Use cases
- flight compare
- travel decision support
Access
- REST:
POST https://marketplace.rafidsystem.com/api/v1/travel/flight-compare - x402:
POST https://marketplace.rafidsystem.com/api/v1/x402/travel/flight-compare - MCP tool:
flight_compare - Free preview:
POST https://marketplace.rafidsystem.com/api/v1/preview/flight_compare
Price: $0.15 USD per call. Payment options are deployment-configured; inspect /api/v1/payment-methods. Prices and payment semantics are unchanged from the canonical registry.
Get the full result
0.15 USD per call
Try free preview · limited information, no charge
curl -X POST 'https://marketplace.rafidsystem.com/api/v1/preview/flight_compare' -H 'Content-Type: application/json' --data '{"origin":"MCT","destination":"DXB","departureDate":"2026-11-10","returnDate":"2026-11-13","currency":"USD"}'Payment instructions and onboarding · API docs and schemas
These are copyable API integration requests. They do not open a checkout or execute a paid tool.
Related tools
Example input
{
"origin": "MCT",
"destination": "DXB",
"departureDate": "2026-11-10",
"returnDate": "2026-11-13",
"currency": "USD"
}Example output
{
"recommended": null,
"cheapest": null,
"fastest": null,
"fewestStops": null,
"alternatives": [],
"comparison": {
"priceRange": null,
"durationRangeMinutes": null
},
"reasonCodes": [
"NO_FLIGHT_RESULTS"
],
"methodology": {
"type": "deterministic_weighted_comparison",
"weights": {
"priceWeight": 0.5,
"durationWeight": 0.25,
"stopsWeight": 0.15,
"reliabilityWeight": 0.1
},
"scope": "Returned offers only",
"missingSignals": "Missing signals excluded"
},
"searchedAt": "2026-10-04T00:00:00.000Z",
"provider": {
"name": "letsfg",
"status": "ok",
"upstreamLatencyMs": 0
},
"dataMode": "live"
}Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"origin": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[\\p{L}\\p{N} .,'()-]+$"
},
"destination": {
"type": "string",
"minLength": 2,
"maxLength": 100,
"pattern": "^[\\p{L}\\p{N} .,'()-]+$"
},
"departureDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"returnDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"adults": {
"default": 1,
"type": "integer",
"minimum": 1,
"maximum": 9
},
"children": {
"default": 0,
"type": "integer",
"minimum": 0,
"maximum": 8
},
"infants": {
"default": 0,
"description": "Infant pricing is not supported by this adapter.",
"type": "number",
"const": 0
},
"cabinClass": {
"default": "economy",
"type": "string",
"enum": [
"economy",
"premium_economy",
"business",
"first"
]
},
"currency": {
"default": "USD",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"maxStops": {
"type": "integer",
"minimum": 0,
"maximum": 3
},
"limit": {
"default": 20,
"type": "integer",
"minimum": 1,
"maximum": 50
},
"sort": {
"default": "price",
"type": "string",
"enum": [
"price",
"duration",
"stops"
]
},
"preferences": {
"default": {
"priceWeight": 0.5,
"durationWeight": 0.25,
"stopsWeight": 0.15,
"reliabilityWeight": 0.1
},
"type": "object",
"properties": {
"priceWeight": {
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"durationWeight": {
"default": 0.25,
"type": "number",
"minimum": 0,
"maximum": 1
},
"stopsWeight": {
"default": 0.15,
"type": "number",
"minimum": 0,
"maximum": 1
},
"reliabilityWeight": {
"default": 0.1,
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"priceWeight",
"durationWeight",
"stopsWeight",
"reliabilityWeight"
],
"additionalProperties": false
}
},
"required": [
"origin",
"destination",
"departureDate",
"adults",
"children",
"infants",
"cabinClass",
"currency",
"limit",
"sort",
"preferences"
],
"additionalProperties": false
}Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"properties": {
"recommended": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"airlines": {
"type": "array",
"items": {
"type": "string"
}
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": [
"string",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"airline": {
"type": [
"string",
"null"
]
}
},
"required": [
"origin",
"destination",
"departureAt",
"arrivalAt",
"airline"
],
"additionalProperties": false
}
},
"stops": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationMinutes": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"reliability": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"baggage": {
"type": [
"string",
"null"
]
},
"splitTicket": {
"type": "boolean"
},
"selfTransfer": {
"type": "boolean"
},
"transferProtection": {
"anyOf": [
{
"type": "string",
"enum": [
"protected",
"unprotected"
]
},
{
"type": "null"
}
]
},
"provider": {
"type": "string",
"const": "letsfg"
}
},
"required": [
"id",
"price",
"airlines",
"segments",
"stops",
"durationMinutes",
"departureAt",
"arrivalAt",
"reliability",
"refundable",
"baggage",
"splitTicket",
"selfTransfer",
"provider"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"cheapest": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"airlines": {
"type": "array",
"items": {
"type": "string"
}
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": [
"string",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"airline": {
"type": [
"string",
"null"
]
}
},
"required": [
"origin",
"destination",
"departureAt",
"arrivalAt",
"airline"
],
"additionalProperties": false
}
},
"stops": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationMinutes": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"reliability": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"baggage": {
"type": [
"string",
"null"
]
},
"splitTicket": {
"type": "boolean"
},
"selfTransfer": {
"type": "boolean"
},
"transferProtection": {
"anyOf": [
{
"type": "string",
"enum": [
"protected",
"unprotected"
]
},
{
"type": "null"
}
]
},
"provider": {
"type": "string",
"const": "letsfg"
}
},
"required": [
"id",
"price",
"airlines",
"segments",
"stops",
"durationMinutes",
"departureAt",
"arrivalAt",
"reliability",
"refundable",
"baggage",
"splitTicket",
"selfTransfer",
"provider"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"fastest": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"airlines": {
"type": "array",
"items": {
"type": "string"
}
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": [
"string",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"airline": {
"type": [
"string",
"null"
]
}
},
"required": [
"origin",
"destination",
"departureAt",
"arrivalAt",
"airline"
],
"additionalProperties": false
}
},
"stops": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationMinutes": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"reliability": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"baggage": {
"type": [
"string",
"null"
]
},
"splitTicket": {
"type": "boolean"
},
"selfTransfer": {
"type": "boolean"
},
"transferProtection": {
"anyOf": [
{
"type": "string",
"enum": [
"protected",
"unprotected"
]
},
{
"type": "null"
}
]
},
"provider": {
"type": "string",
"const": "letsfg"
}
},
"required": [
"id",
"price",
"airlines",
"segments",
"stops",
"durationMinutes",
"departureAt",
"arrivalAt",
"reliability",
"refundable",
"baggage",
"splitTicket",
"selfTransfer",
"provider"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"fewestStops": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"airlines": {
"type": "array",
"items": {
"type": "string"
}
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": [
"string",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"airline": {
"type": [
"string",
"null"
]
}
},
"required": [
"origin",
"destination",
"departureAt",
"arrivalAt",
"airline"
],
"additionalProperties": false
}
},
"stops": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationMinutes": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"reliability": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"baggage": {
"type": [
"string",
"null"
]
},
"splitTicket": {
"type": "boolean"
},
"selfTransfer": {
"type": "boolean"
},
"transferProtection": {
"anyOf": [
{
"type": "string",
"enum": [
"protected",
"unprotected"
]
},
{
"type": "null"
}
]
},
"provider": {
"type": "string",
"const": "letsfg"
}
},
"required": [
"id",
"price",
"airlines",
"segments",
"stops",
"durationMinutes",
"departureAt",
"arrivalAt",
"reliability",
"refundable",
"baggage",
"splitTicket",
"selfTransfer",
"provider"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"price": {
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"airlines": {
"type": "array",
"items": {
"type": "string"
}
},
"segments": {
"type": "array",
"items": {
"type": "object",
"properties": {
"origin": {
"type": [
"string",
"null"
]
},
"destination": {
"type": [
"string",
"null"
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"airline": {
"type": [
"string",
"null"
]
}
},
"required": [
"origin",
"destination",
"departureAt",
"arrivalAt",
"airline"
],
"additionalProperties": false
}
},
"stops": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"durationMinutes": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"departureAt": {
"type": [
"string",
"null"
]
},
"arrivalAt": {
"type": [
"string",
"null"
]
},
"reliability": {
"anyOf": [
{
"type": "number",
"minimum": 0,
"maximum": 1
},
{
"type": "null"
}
]
},
"refundable": {
"type": [
"boolean",
"null"
]
},
"baggage": {
"type": [
"string",
"null"
]
},
"splitTicket": {
"type": "boolean"
},
"selfTransfer": {
"type": "boolean"
},
"transferProtection": {
"anyOf": [
{
"type": "string",
"enum": [
"protected",
"unprotected"
]
},
{
"type": "null"
}
]
},
"provider": {
"type": "string",
"const": "letsfg"
}
},
"required": [
"id",
"price",
"airlines",
"segments",
"stops",
"durationMinutes",
"departureAt",
"arrivalAt",
"reliability",
"refundable",
"baggage",
"splitTicket",
"selfTransfer",
"provider"
],
"additionalProperties": false
}
},
"comparison": {
"type": "object",
"properties": {
"priceRange": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"durationRangeMinutes": {
"anyOf": [
{
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"priceRange",
"durationRangeMinutes"
],
"additionalProperties": false
},
"reasonCodes": {
"type": "array",
"items": {
"type": "string"
}
},
"methodology": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "deterministic_weighted_comparison"
},
"weights": {
"type": "object",
"properties": {
"priceWeight": {
"default": 0.5,
"type": "number",
"minimum": 0,
"maximum": 1
},
"durationWeight": {
"default": 0.25,
"type": "number",
"minimum": 0,
"maximum": 1
},
"stopsWeight": {
"default": 0.15,
"type": "number",
"minimum": 0,
"maximum": 1
},
"reliabilityWeight": {
"default": 0.1,
"type": "number",
"minimum": 0,
"maximum": 1
}
},
"required": [
"priceWeight",
"durationWeight",
"stopsWeight",
"reliabilityWeight"
],
"additionalProperties": false
},
"scope": {
"type": "string"
},
"missingSignals": {
"type": "string"
}
},
"required": [
"type",
"weights",
"scope",
"missingSignals"
],
"additionalProperties": false
},
"searchedAt": {
"type": "string"
},
"provider": {
"type": "object",
"properties": {
"name": {
"type": "string",
"const": "letsfg"
},
"status": {
"type": "string",
"const": "ok"
},
"upstreamLatencyMs": {
"type": "number",
"minimum": 0
}
},
"required": [
"name",
"status",
"upstreamLatencyMs"
],
"additionalProperties": false
},
"dataMode": {
"type": "string",
"const": "live"
}
},
"required": [
"recommended",
"cheapest",
"fastest",
"fewestStops",
"alternatives",
"comparison",
"reasonCodes",
"methodology",
"searchedAt",
"provider",
"dataMode"
],
"additionalProperties": false
}Category: travel · hierarchy: supporting · idempotent: yes · side effects: no