{ "agentSkill": { "auth": "none", "description": "Discover submission rules, preview observed fares, submit for verification and recover decisions", "digest": "sha256:1ffca4d9654c7e84db39181d654a5027b60eda9c0cfd6d3287d4b6980f14d9a3", "download_url": "https://www.sparkflights.com/agent-skills/sparkflights/package.zip", "id": "sparkflights", "name": "SparkFlights", "package_digest": "sha256:db46d60cd32cfbe3d4716db9d671dda5a2d32db39decb05f7e31ab8f8deabf5c", "type": "skill", "url": "https://www.sparkflights.com/agent-skills/sparkflights/SKILL.md" }, "authentication": { "schemes": [ { "description": "Optional. For on-page attribution and leaderboard credit: POST /api/v1/agents/register (free, no auth) to get a key, then pass it here on every request.", "in": "header", "name": "X-Agent-Key", "scheme": "apiKey" }, { "description": "Opaque scoped credit credential. Required for account, earnings, and referral skills; optional for anonymous submission. Invalid supplied credentials are rejected.", "scheme": "bearer" } ] }, "capabilities": { "pushNotifications": false, "streaming": false }, "defaultInputModes": [ "application/json" ], "defaultOutputModes": [ "application/json" ], "description": "Search and retrieve verified flight deals ranked by cost per mile, with affiliate booking links for Google Flights, Skyscanner, Kayak, and Aviasales.", "name": "Sparkflights Flight Deals", "protocolVersion": "0.2.1", "skills": [ { "description": "Search current verified flight deals by destination, origin, cabin class, and region. Returns deals ranked by value with affiliate booking links.", "id": "search-deals", "inputModes": [ "application/json" ], "name": "Search Deals", "outputModes": [ "application/json" ], "tags": [ "flights", "deals", "travel", "airfare" ] }, { "description": "Get full details for a specific flight deal by ID, including date options and affiliate booking links.", "id": "get-deal", "inputModes": [ "application/json" ], "name": "Get Deal", "outputModes": [ "application/json" ], "tags": [ "flights", "deals", "travel" ] }, { "description": "Submit feedback about the Sparkflights API, MCP tools, or discovery endpoints. Helps improve the service for all agents.", "id": "submit-feedback", "inputModes": [ "application/json" ], "name": "Submit Feedback", "outputModes": [ "application/json" ], "tags": [ "feedback", "api", "improvement" ] }, { "description": "Read your account and credential scopes; requires account:read.", "id": "get-credit-account", "inputModes": [ "application/json" ], "name": "get_credit_account", "outputModes": [ "application/json" ] }, { "description": "Read held, nonpayable allocations; requires account:read. No payouts are enabled.", "id": "get-credit-earnings", "inputModes": [ "application/json" ], "name": "get_credit_earnings", "outputModes": [ "application/json" ] }, { "description": "Create an explicit public referral link for your account; requires referrals:write.", "id": "create-referral", "inputModes": [ "application/json" ], "name": "create_referral", "outputModes": [ "application/json" ] }, { "description": "Discover current required fields, publication ceilings, plausibility, verification sources, unverified review gates, listing filters, authentication and retry rules. No provider or LLM calls.", "id": "get-submission-policy", "inputModes": [ "application/json" ], "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "get_submission_policy", "outputModes": [ "application/json" ], "outputSchema": { "additionalProperties": false, "properties": { "authentication": { "type": "string" }, "ceilings": { "additionalProperties": false, "properties": { "Cabin": { "additionalProperties": { "type": "number" }, "type": "object" }, "LowCost": { "additionalProperties": { "type": "number" }, "type": "object" }, "Overrides": { "additionalProperties": { "additionalProperties": { "type": "number" }, "type": "object" }, "type": "object" } }, "required": [ "Cabin", "LowCost", "Overrides" ], "type": "object" }, "conditional_fields": { "additionalProperties": { "type": "string" }, "type": "object" }, "defaults": { "additionalProperties": { "type": "string" }, "type": "object" }, "distance_basis": { "type": "string" }, "hard_rules": { "additionalProperties": false, "properties": { "departure_today_or_later_required": { "type": "boolean" }, "excluded_airports": { "items": { "type": "string" }, "type": "array" }, "max_plausible_cpm_by_cabin": { "additionalProperties": { "type": "number" }, "type": "object" }, "min_plausible_cpm": { "type": "number" }, "min_premium_price_usd": { "type": "number" }, "min_premium_route_miles": { "type": "number" }, "min_route_miles": { "type": "number" }, "policy_implementation": { "type": "string" } }, "required": [ "min_route_miles", "min_premium_route_miles", "min_premium_price_usd", "min_plausible_cpm", "max_plausible_cpm_by_cabin", "excluded_airports", "departure_today_or_later_required", "policy_implementation" ], "type": "object" }, "listing_visibility": { "additionalProperties": false, "properties": { "main_board_excludes_budget": { "type": "boolean" }, "max_age_hours": { "type": "integer" }, "max_ratio": { "type": "number" }, "min_distance_miles": { "type": "integer" }, "min_price_usd": { "type": "integer" }, "min_score": { "type": "integer" }, "origin_regions": { "items": { "type": "string" }, "type": "array" } }, "required": [ "min_score", "max_ratio", "max_age_hours", "min_distance_miles", "min_price_usd", "origin_regions", "main_board_excludes_budget" ], "type": "object" }, "policy_version": { "type": "string" }, "price_basis": { "type": "string" }, "required_fields": { "items": { "type": "string" }, "type": "array" }, "retry_requirements": { "type": "string" }, "schema_version": { "type": "string" }, "score_purpose": { "type": "string" }, "supported_sources": { "items": { "type": "string" }, "type": "array" }, "unverified_review": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "max_probe_ratio": { "type": "number" }, "zero_disables_ratio_gate": { "type": "boolean" } }, "required": [ "max_probe_ratio", "zero_disables_ratio_gate", "description" ], "type": "object" }, "verification": { "type": "string" } }, "required": [ "schema_version", "policy_version", "price_basis", "required_fields", "conditional_fields", "defaults", "ceilings", "hard_rules", "unverified_review", "listing_visibility", "supported_sources", "verification", "authentication", "retry_requirements", "score_purpose", "distance_basis" ], "type": "object" } }, { "description": "Check the claimed fare against current local rules with no provider/LLM calls or publication writes. Passing does not guarantee availability, publication or novelty. Verification is always not_attempted.", "id": "preview-deal", "inputModes": [ "application/json" ], "inputSchema": { "additionalProperties": false, "properties": { "airline": { "description": "Observed candidate airline; does not restrict live route discovery", "type": "string" }, "booking_url": { "description": "Absolute HTTPS selected Google Flights booking link; unsupported sources may require review", "type": "string" }, "cabin_class": { "default": "economy", "enum": [ "economy", "premium_economy", "business", "first" ], "type": "string" }, "comparison": { "additionalProperties": false, "properties": { "destination_airports": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "destination_market": { "enum": [ "NYC" ], "type": "string" }, "fare_requirements": { "items": { "type": "string" }, "type": "array" }, "origin_airports": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "origin_market": { "enum": [ "NYC" ], "type": "string" } }, "type": "object" }, "depart_date": { "description": "Required YYYY-MM-DD, today or later", "type": "string" }, "destination": { "description": "Destination IATA airport code", "type": "string" }, "notes": { "description": "Factual context", "type": "string" }, "origin": { "description": "Origin IATA airport code", "type": "string" }, "price_usd": { "description": "Observed total in USD for one adult including mandatory taxes and fees", "exclusiveMinimum": 0, "type": "number" }, "return_date": { "description": "Required for round_trip, after depart_date; prohibited for one_way", "type": "string" }, "source_url": { "description": "Absolute HTTPS discovery source; used for verification when booking_url is absent", "type": "string" }, "trip_type": { "default": "round_trip", "enum": [ "round_trip", "one_way" ], "type": "string" } }, "required": [ "origin", "destination", "price_usd", "depart_date" ], "type": "object" }, "name": "preview_deal", "outputModes": [ "application/json" ], "outputSchema": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "eligibility": { "additionalProperties": false, "properties": { "billable_miles": { "type": "number" }, "ceiling_cpm": { "type": "number" }, "checked_price_usd": { "type": "number" }, "cpm": { "type": "number" }, "distance_miles": { "type": "number" }, "failed_checks": { "items": { "additionalProperties": false, "properties": { "actual": true, "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" }, "threshold": true, "units": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "type": "array" }, "low_cost": { "type": "boolean" }, "market": { "type": "string" }, "max_price_usd": { "type": "number" }, "price_basis": { "type": "string" }, "score": { "type": "integer" }, "state": { "type": "string" }, "unverified_review_failed_checks": { "items": { "additionalProperties": false, "properties": { "actual": true, "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" }, "threshold": true, "units": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "type": "array" } }, "required": [ "state", "price_basis", "checked_price_usd", "low_cost", "unverified_review_failed_checks", "score", "failed_checks" ], "type": "object" }, "message": { "type": "string" }, "next_actions": { "items": { "additionalProperties": false, "properties": { "action": { "type": "string" }, "message": { "type": "string" }, "retry_after_seconds": { "type": "integer" } }, "required": [ "action", "message" ], "type": "object" }, "type": "array" }, "normalized_input": { "additionalProperties": false, "properties": { "airline": { "type": "string" }, "booking_url": { "type": "string" }, "cabin_class": { "type": "string" }, "comparison": { "additionalProperties": false, "properties": { "destination_airports": { "items": { "type": "string" }, "type": "array" }, "destination_market": { "type": "string" }, "fare_requirements": { "items": { "type": "string" }, "type": "array" }, "origin_airports": { "items": { "type": "string" }, "type": "array" }, "origin_market": { "type": "string" } }, "type": "object" }, "delegation_id": { "type": "string" }, "depart_date": { "type": "string" }, "destination": { "type": "string" }, "idempotency_key": { "type": "string" }, "notes": { "type": "string" }, "origin": { "type": "string" }, "price_usd": { "type": "number" }, "return_date": { "type": "string" }, "source_url": { "type": "string" }, "trip_type": { "type": "string" } }, "required": [ "origin", "destination", "price_usd", "cabin_class", "trip_type", "depart_date", "return_date", "airline", "booking_url", "source_url", "notes" ], "type": "object" }, "policy_version": { "type": "string" }, "retryable": { "type": "boolean" }, "schema_version": { "type": "string" }, "verification": { "additionalProperties": false, "properties": { "lowest_quote_usd": { "type": "number" }, "provider_quote_count": { "type": "integer" }, "quote_count": { "type": "integer" }, "route_offer_count": { "type": "integer" }, "source": { "type": "string" }, "state": { "type": "string" }, "submitted_link": { "additionalProperties": false, "properties": { "lowest_quote_usd": { "type": "number" }, "quote_count": { "type": "integer" }, "source": { "type": "string" }, "state": { "type": "string" } }, "required": [ "state", "quote_count" ], "type": "object" } }, "required": [ "state", "quote_count" ], "type": "object" } }, "required": [ "schema_version", "policy_version", "code", "normalized_input", "verification", "eligibility", "retryable", "next_actions", "message" ], "type": "object" } }, { "description": "Submit an observed fare for live verification. Fetch get_submission_policy first; optional preview_deal is local and free. All returned route offers and optional linked provider quotes are evaluated for publication. Anonymous submission is allowed; registration enables attribution and reliable retries. Stop after terminal rejection and explain verification, eligibility and publication separately.", "id": "submit-deal", "inputModes": [ "application/json" ], "inputSchema": { "additionalProperties": false, "properties": { "agent_key": { "description": "Optional legacy credential; prefer Authorization: Bearer", "type": "string" }, "airline": { "description": "Observed candidate airline; does not restrict live route discovery", "type": "string" }, "booking_url": { "description": "Absolute HTTPS selected Google Flights booking link; unsupported sources may require review", "type": "string" }, "cabin_class": { "default": "economy", "enum": [ "economy", "premium_economy", "business", "first" ], "type": "string" }, "comparison": { "additionalProperties": false, "properties": { "destination_airports": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "destination_market": { "enum": [ "NYC" ], "type": "string" }, "fare_requirements": { "items": { "type": "string" }, "type": "array" }, "origin_airports": { "items": { "pattern": "^[A-Z]{3}$", "type": "string" }, "type": "array" }, "origin_market": { "enum": [ "NYC" ], "type": "string" } }, "type": "object" }, "delegation_id": { "description": "Explicit user-authorized delegation; requires a credential", "type": "string" }, "depart_date": { "description": "Required YYYY-MM-DD, today or later", "type": "string" }, "destination": { "description": "Destination IATA airport code", "type": "string" }, "idempotency_key": { "description": "Credential-scoped stable key. Preserve for identical retries; new key for changed input", "maxLength": 128, "type": "string" }, "notes": { "description": "Factual context", "type": "string" }, "origin": { "description": "Origin IATA airport code", "type": "string" }, "price_usd": { "description": "Observed total in USD for one adult including mandatory taxes and fees", "exclusiveMinimum": 0, "type": "number" }, "return_date": { "description": "Required for round_trip, after depart_date; prohibited for one_way", "type": "string" }, "source_url": { "description": "Absolute HTTPS discovery source; used for verification when booking_url is absent", "type": "string" }, "trip_type": { "default": "round_trip", "enum": [ "round_trip", "one_way" ], "type": "string" } }, "required": [ "origin", "destination", "price_usd", "depart_date" ], "type": "object" }, "name": "submit_deal", "outputModes": [ "application/json" ], "outputSchema": { "additionalProperties": false, "properties": { "hint": { "type": "string" }, "result": { "additionalProperties": false, "properties": { "account_id": { "type": "integer" }, "booking_lookups": { "items": { "additionalProperties": false, "properties": { "backend": { "type": "string" }, "basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "trip_type": { "type": "string" } }, "required": [ "trip_type", "cabin", "currency", "passengers", "journeys" ], "type": "object" }, "cache": { "additionalProperties": false, "properties": { "age_seconds": { "type": "integer" }, "hit": { "type": "boolean" } }, "required": [ "hit", "age_seconds" ], "type": "object" }, "contract_version": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "observed_at": { "format": "date-time", "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "other_cabin_options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "outcome": { "type": "string" }, "reason": { "type": "string" }, "source": { "type": "string" } }, "required": [ "contract_version", "backend", "source", "outcome", "basis", "journeys", "observed_at", "expires_at", "cache", "options" ], "type": "object" }, "type": "array" }, "code": { "type": "string" }, "contribution_id": { "type": "integer" }, "deal_id": { "type": "integer" }, "eligibility": { "additionalProperties": false, "properties": { "billable_miles": { "type": "number" }, "ceiling_cpm": { "type": "number" }, "checked_price_usd": { "type": "number" }, "cpm": { "type": "number" }, "distance_miles": { "type": "number" }, "failed_checks": { "items": { "additionalProperties": false, "properties": { "actual": true, "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" }, "threshold": true, "units": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "type": "array" }, "low_cost": { "type": "boolean" }, "market": { "type": "string" }, "max_price_usd": { "type": "number" }, "price_basis": { "type": "string" }, "score": { "type": "integer" }, "state": { "type": "string" }, "unverified_review_failed_checks": { "items": { "additionalProperties": false, "properties": { "actual": true, "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" }, "threshold": true, "units": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "type": "array" } }, "required": [ "state", "price_basis", "checked_price_usd", "low_cost", "unverified_review_failed_checks", "score", "failed_checks" ], "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "trip_type": { "type": "string" } }, "required": [ "trip_type", "cabin", "currency", "passengers", "journeys" ], "type": "object" }, "booking_evidence": { "additionalProperties": false, "properties": { "backend": { "type": "string" }, "basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "trip_type": { "type": "string" } }, "required": [ "trip_type", "cabin", "currency", "passengers", "journeys" ], "type": "object" }, "cache": { "additionalProperties": false, "properties": { "age_seconds": { "type": "integer" }, "hit": { "type": "boolean" } }, "required": [ "hit", "age_seconds" ], "type": "object" }, "contract_version": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "observed_at": { "format": "date-time", "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "other_cabin_options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "outcome": { "type": "string" }, "reason": { "type": "string" }, "source": { "type": "string" } }, "required": [ "contract_version", "backend", "source", "outcome", "basis", "journeys", "observed_at", "expires_at", "cache", "options" ], "type": "object" }, "checked_at": { "format": "date-time", "type": "string" }, "conditions": { "type": "string" }, "currency": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "fare_brand": { "type": "string" }, "key": { "type": "string" }, "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" }, "lookup_outcome": { "type": "string" }, "provider_code": { "type": "string" }, "search_basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "depart_date": { "type": "string" }, "destination": { "additionalProperties": false, "properties": { "allowed_airports": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "scope", "id" ], "type": "object" }, "fare_requirements": { "items": { "type": "string" }, "type": "array" }, "origin": { "additionalProperties": false, "properties": { "allowed_airports": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "scope", "id" ], "type": "object" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "policy_version": { "type": "string" }, "return_date": { "type": "string" }, "trip_type": { "type": "string" } }, "required": [ "policy_version", "origin", "destination", "depart_date", "trip_type", "cabin", "passengers", "currency" ], "type": "object" }, "seller": { "type": "string" }, "source": { "type": "string" }, "state": { "type": "string" }, "total_minor": { "type": "integer" }, "url": { "type": "string" } }, "required": [ "key", "source", "state", "url", "total_minor", "currency", "adults", "checked_at", "expires_at" ], "type": "object" }, "existing_price": { "type": "number" }, "hint": { "type": "string" }, "message": { "type": "string" }, "next_action": { "type": "string" }, "next_actions": { "items": { "additionalProperties": false, "properties": { "action": { "type": "string" }, "message": { "type": "string" }, "retry_after_seconds": { "type": "integer" } }, "required": [ "action", "message" ], "type": "object" }, "type": "array" }, "policy_version": { "type": "string" }, "publication_price": { "type": "number" }, "reason": { "type": "string" }, "retryable": { "type": "boolean" }, "savings": { "type": "number" }, "schema_version": { "type": "string" }, "score": { "type": "integer" }, "status": { "type": "string" }, "submission_id": { "type": "integer" }, "submitted_price": { "type": "number" }, "verification": { "additionalProperties": false, "properties": { "lowest_quote_usd": { "type": "number" }, "provider_quote_count": { "type": "integer" }, "quote_count": { "type": "integer" }, "route_offer_count": { "type": "integer" }, "source": { "type": "string" }, "state": { "type": "string" }, "submitted_link": { "additionalProperties": false, "properties": { "lowest_quote_usd": { "type": "number" }, "quote_count": { "type": "integer" }, "source": { "type": "string" }, "state": { "type": "string" } }, "required": [ "state", "quote_count" ], "type": "object" } }, "required": [ "state", "quote_count" ], "type": "object" }, "verification_reason": { "type": "string" }, "verified_price": { "type": "number" } }, "required": [ "status", "message" ], "type": "object" } }, "required": [ "result" ], "type": "object" } }, { "description": "Read your recorded canonical submission by contribution_id, including pending decisions. Requires account:read. Another owner's ID returns the same not_found result as a missing ID.", "id": "get-submission", "inputModes": [ "application/json" ], "inputSchema": { "additionalProperties": false, "properties": { "agent_key": { "description": "Optional legacy credential; prefer Authorization: Bearer", "type": "string" }, "id": { "description": "Canonical contribution_id from submission", "minimum": 1, "type": "integer" } }, "required": [ "id" ], "type": "object" }, "name": "get_submission", "outputModes": [ "application/json" ], "outputSchema": { "additionalProperties": false, "properties": { "hint": { "type": "string" }, "result": { "additionalProperties": false, "properties": { "account_id": { "type": "integer" }, "booking_lookups": { "items": { "additionalProperties": false, "properties": { "backend": { "type": "string" }, "basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "trip_type": { "type": "string" } }, "required": [ "trip_type", "cabin", "currency", "passengers", "journeys" ], "type": "object" }, "cache": { "additionalProperties": false, "properties": { "age_seconds": { "type": "integer" }, "hit": { "type": "boolean" } }, "required": [ "hit", "age_seconds" ], "type": "object" }, "contract_version": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "observed_at": { "format": "date-time", "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "other_cabin_options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "outcome": { "type": "string" }, "reason": { "type": "string" }, "source": { "type": "string" } }, "required": [ "contract_version", "backend", "source", "outcome", "basis", "journeys", "observed_at", "expires_at", "cache", "options" ], "type": "object" }, "type": "array" }, "code": { "type": "string" }, "contribution_id": { "type": "integer" }, "deal_id": { "type": "integer" }, "eligibility": { "additionalProperties": false, "properties": { "billable_miles": { "type": "number" }, "ceiling_cpm": { "type": "number" }, "checked_price_usd": { "type": "number" }, "cpm": { "type": "number" }, "distance_miles": { "type": "number" }, "failed_checks": { "items": { "additionalProperties": false, "properties": { "actual": true, "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" }, "threshold": true, "units": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "type": "array" }, "low_cost": { "type": "boolean" }, "market": { "type": "string" }, "max_price_usd": { "type": "number" }, "price_basis": { "type": "string" }, "score": { "type": "integer" }, "state": { "type": "string" }, "unverified_review_failed_checks": { "items": { "additionalProperties": false, "properties": { "actual": true, "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" }, "threshold": true, "units": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "type": "array" } }, "required": [ "state", "price_basis", "checked_price_usd", "low_cost", "unverified_review_failed_checks", "score", "failed_checks" ], "type": "object" }, "evidence": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "trip_type": { "type": "string" } }, "required": [ "trip_type", "cabin", "currency", "passengers", "journeys" ], "type": "object" }, "booking_evidence": { "additionalProperties": false, "properties": { "backend": { "type": "string" }, "basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "trip_type": { "type": "string" } }, "required": [ "trip_type", "cabin", "currency", "passengers", "journeys" ], "type": "object" }, "cache": { "additionalProperties": false, "properties": { "age_seconds": { "type": "integer" }, "hit": { "type": "boolean" } }, "required": [ "hit", "age_seconds" ], "type": "object" }, "contract_version": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "journeys": { "items": { "additionalProperties": false, "properties": { "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" } }, "required": [ "legs" ], "type": "object" }, "type": "array" }, "observed_at": { "format": "date-time", "type": "string" }, "options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "other_cabin_options": { "items": { "additionalProperties": false, "properties": { "booking_path": { "additionalProperties": false, "properties": { "method": { "type": "string" }, "parameters": { "items": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "type": "array" }, "url": { "type": "string" } }, "required": [ "url", "method", "parameters" ], "type": "object" }, "currency": { "type": "string" }, "fare_label": { "type": "string" }, "is_airline": { "type": "boolean" }, "leg_cabins": { "items": { "type": "string" }, "type": "array" }, "provider": { "type": "string" }, "provider_code": { "type": "string" }, "total_minor": { "type": "integer" } }, "required": [ "provider", "provider_code", "is_airline", "total_minor", "currency", "leg_cabins" ], "type": "object" }, "type": "array" }, "outcome": { "type": "string" }, "reason": { "type": "string" }, "source": { "type": "string" } }, "required": [ "contract_version", "backend", "source", "outcome", "basis", "journeys", "observed_at", "expires_at", "cache", "options" ], "type": "object" }, "checked_at": { "format": "date-time", "type": "string" }, "conditions": { "type": "string" }, "currency": { "type": "string" }, "expires_at": { "format": "date-time", "type": "string" }, "fare_brand": { "type": "string" }, "key": { "type": "string" }, "legs": { "items": { "additionalProperties": false, "properties": { "arrival_date": { "type": "string" }, "arrival_time": { "type": "string" }, "cabin": { "type": "string" }, "carrier": { "type": "string" }, "date": { "type": "string" }, "departure_time": { "type": "string" }, "flight_number": { "type": "string" }, "from": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to", "date", "carrier", "flight_number" ], "type": "object" }, "type": "array" }, "lookup_outcome": { "type": "string" }, "provider_code": { "type": "string" }, "search_basis": { "additionalProperties": false, "properties": { "cabin": { "type": "string" }, "currency": { "type": "string" }, "depart_date": { "type": "string" }, "destination": { "additionalProperties": false, "properties": { "allowed_airports": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "scope", "id" ], "type": "object" }, "fare_requirements": { "items": { "type": "string" }, "type": "array" }, "origin": { "additionalProperties": false, "properties": { "allowed_airports": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "scope", "id" ], "type": "object" }, "passengers": { "additionalProperties": false, "properties": { "adults": { "type": "integer" }, "children": { "type": "integer" }, "infants_lap": { "type": "integer" }, "infants_seat": { "type": "integer" } }, "required": [ "adults", "children", "infants_lap", "infants_seat" ], "type": "object" }, "policy_version": { "type": "string" }, "return_date": { "type": "string" }, "trip_type": { "type": "string" } }, "required": [ "policy_version", "origin", "destination", "depart_date", "trip_type", "cabin", "passengers", "currency" ], "type": "object" }, "seller": { "type": "string" }, "source": { "type": "string" }, "state": { "type": "string" }, "total_minor": { "type": "integer" }, "url": { "type": "string" } }, "required": [ "key", "source", "state", "url", "total_minor", "currency", "adults", "checked_at", "expires_at" ], "type": "object" }, "existing_price": { "type": "number" }, "hint": { "type": "string" }, "message": { "type": "string" }, "next_action": { "type": "string" }, "next_actions": { "items": { "additionalProperties": false, "properties": { "action": { "type": "string" }, "message": { "type": "string" }, "retry_after_seconds": { "type": "integer" } }, "required": [ "action", "message" ], "type": "object" }, "type": "array" }, "policy_version": { "type": "string" }, "publication_price": { "type": "number" }, "reason": { "type": "string" }, "retryable": { "type": "boolean" }, "savings": { "type": "number" }, "schema_version": { "type": "string" }, "score": { "type": "integer" }, "status": { "type": "string" }, "submission_id": { "type": "integer" }, "submitted_price": { "type": "number" }, "verification": { "additionalProperties": false, "properties": { "lowest_quote_usd": { "type": "number" }, "provider_quote_count": { "type": "integer" }, "quote_count": { "type": "integer" }, "route_offer_count": { "type": "integer" }, "source": { "type": "string" }, "state": { "type": "string" }, "submitted_link": { "additionalProperties": false, "properties": { "lowest_quote_usd": { "type": "number" }, "quote_count": { "type": "integer" }, "source": { "type": "string" }, "state": { "type": "string" } }, "required": [ "state", "quote_count" ], "type": "object" } }, "required": [ "state", "quote_count" ], "type": "object" }, "verification_reason": { "type": "string" }, "verified_price": { "type": "number" } }, "required": [ "status", "message" ], "type": "object" } }, "required": [ "result" ], "type": "object" } } ], "supportedInterfaces": [ { "protocolBinding": "JSONRPC", "protocolVersion": "0.2.1", "url": "https://www.sparkflights.com/a2a" } ], "url": "https://www.sparkflights.com/a2a", "version": "1.0.0" }