Windsock
Aircraft intelligence for developers: valuations with confidence bands, FAA registry lookups and fleet search, cost of ownership, comparable aircraft,…
Logistics & shipping#transportation
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Aircraft intelligence for developers: valuations with confidence bands, FAA registry lookups and fleet search, cost of ownership, comparable aircraft, airworthiness directives and STCs, avionics references, airport data and weather, market metrics with forecasts, price-index time series, logbook search and verified value reports. Key-authenticated (X-API-Key); free tier plus paid API plans at https://windsock.ai/pricing. Interactive reference: https://windsock.ai/app/docs. Contract is frozen — breaking changes are blocked in CI. The same capabilities are exposed to AI agents over MCP at https://windsock.ai/mcp.
Endpoints 124
v3
- GET`GET /api/v3/account` — current user's plan/tier + the rate-limit matrix.
/api/v3/account - GET`GET /api/v3/account/usage` — month-to-date usage, limits, and the estimated
monthly cost.
/api/v3/account/usage - POST`POST /api/v3/aircraft/infer-specs` — infer aircraft specs from listing text and/or screenshots.
/api/v3/aircraft/infer-specs - POST`POST /api/v3/aircraft/search` — registry-wide aircraft search.
/api/v3/aircraft/search - POST`POST /api/v3/aircraft/search/histogram` — registry census totals with state and year breakdowns.
/api/v3/aircraft/search/histogram - POST`POST /api/v3/aircraft/search/suggest` — plain-words aircraft search.
/api/v3/aircraft/search/suggestDescribe the aircraft you want; get filters back, and with execute: true the matching aircraft. Send the returned filters back without a prompt to page or… - GET`GET /api/v3/aircraft/:registration` — canonical registry details for a tail.
/api/v3/aircraft/:registration - GET`GET /api/v3/aircraft/:registration/cost-of-ownership` — cost-of-ownership calculator bootstrap for a tail.
/api/v3/aircraft/:registration/cost-of-ownership - POST`POST /api/v3/aircraft/:registration/flight-activity` — flight-activity prediction for a tail as of a date.
/api/v3/aircraft/:registration/flight-activity - GET`GET /api/v3/aircraft/:registration/similar` — similar aircraft for a tail.
/api/v3/aircraft/:registration/similar - GET`GET /api/v3/airports` — paginated airport list.
/api/v3/airports - POST`POST /api/v3/airports/fuel-forecast` — fuel-price horizon forecast for an airport.
/api/v3/airports/fuel-forecast - GET`GET /api/v3/airports/map-points` — airport map markers.
/api/v3/airports/map-points - GET`GET /api/v3/airports/:ident` — single airport detail by ident.
/api/v3/airports/:ident - GET`GET /api/v3/airports/:ident/metar` — raw and decoded METAR for an airport.
/api/v3/airports/:ident/metar - GET`GET /api/v3/airports/:ident/nearby-aircraft` — aircraft near the airport.
/api/v3/airports/:ident/nearby-aircraft - GET`GET /api/v3/airports/:ident/nearby-aircraft/map-points` — map markers for aircraft near the airport.
/api/v3/airports/:ident/nearby-aircraft/map-points - GET`GET /api/v3/airports/:ident/taf` — Terminal Aerodrome Forecast for an airport.
/api/v3/airports/:ident/taf - GET`GET /api/v3/airports/:ident/weather` — current weather for an airport.
/api/v3/airports/:ident/weather - GET`GET /api/v3/contacts?registrations=N1,N2` — contacts this user has already
revealed (via the API or the Market Research page). Free, no external call.
/api/v3/contacts?registrations=string - POST`POST /api/v3/contacts/reveal` — reveal the owner contact for one aircraft.
/api/v3/contacts/reveal - POST`POST /api/v3/contacts/reveal/bulk` — queue up to 80 registrations for
reveal. Credits are charged per row as the job resolves it, under the same
billable-only rule as a single reveal.
/api/v3/contacts/reveal/bulk - GET`GET /api/v3/contacts/reveal/jobs/{job_id}` — bulk job progress.
/api/v3/contacts/reveal/jobs/:job_id - GET`GET /api/v3/cost-of-ownership/embed/analytics` — daily COO-embed counts +
per-event-type totals + per-identifier facet, scoped to the embed owners.
/api/v3/cost-of-ownership/embed/analytics - GET`GET /api/v3/cost-of-ownership/embed/impressions` — paginated cost-of-ownership embed impression events.
/api/v3/cost-of-ownership/embed/impressions - POST`POST /api/v3/dealflow` — how fast will this aircraft sell at this price? ENTERPRISE / TOP API TIER ONLY.
/api/v3/dealflowDealFlow scores an aircraft's sale velocity: the probability it sells within 90 days at a given price, from the same days-on-market survival model that powers… - GET`GET /api/v3/fleet` — fleet listing for a make and model.
/api/v3/fleet?make_model_id=string - GET`GET /api/v3/fleet/recent-airborne` — recently airborne aircraft in the enterprise fleet.
/api/v3/fleet/recent-airborne - POST`POST /api/v3/flights/categorization` — flight categorizations for a registration.
/api/v3/flights/categorization - GETGET /api/v3/hooks/{platform}/me — the platform's "test this connection" call.
/api/v3/hooks/:platform/me - GETGET /api/v3/hooks/{platform}/sample/{event} — a representative payload.
/api/v3/hooks/:platform/sample/:eventCalled while someone is authoring a Zap or scenario, before any real event has happened, so it must return something even for an account with no history. Each… - POSTPOST /api/v3/hooks/{platform}/subscribe — a Zap or scenario was turned on.
/api/v3/hooks/:platform/subscribe - POSTPOST /api/v3/hooks/{platform}/unsubscribe/{id} — a Zap or scenario was turned off.
/api/v3/hooks/:platform/unsubscribe/:id - GET`GET /api/v3/intake/forms` — list the caller's intake forms.
/api/v3/intake/forms - GET`GET /api/v3/intake/forms/{form_id}` — one form with its full questions.
/api/v3/intake/forms/:form_id - GET`GET /api/v3/intake/forms/{form_id}/analytics` — the funnel: visits,
logged-in visits, started, in-progress, abandoned (idle ≥ stale_days), and
submitted (all-time + windowed), plus a per-day series.
/api/v3/intake/forms/:form_id/analytics - GET`GET /api/v3/intake/forms/{form_id}/submissions` — paginated submissions for
one of the caller's forms (summary rows; newest first).
/api/v3/intake/forms/:form_id/submissions - GET`GET /api/v3/intake/forms/{form_id}/submissions/{submission_id}` — one
submission with every answer, validation verdict, extra info, and readiness.
/api/v3/intake/forms/:form_id/submissions/:submission_id - GET`GET /api/v3/letters` — collapsed list + search.
/api/v3/letters - GET`GET /api/v3/letters/stats` — status-bucket counts over the team scope.
/api/v3/letters/stats - GET`GET /api/v3/letters/:letter_id` — one letter (full projection), team-scoped.
/api/v3/letters/:letter_id - GET`GET /api/v3/locations?q=<text>` — geocode a free-text location.
/api/v3/locations?q=string - POST`POST /api/v3/logbooks/search` — text, semantic, or hybrid logbook search.
/api/v3/logbooks/search - GET`GET /api/v3/market/categories` — market category catalog.
/api/v3/market/categories - GET`GET /api/v3/market/metrics` — market metric catalog.
/api/v3/market/metrics - GET`GET /api/v3/market/metrics/:metric_name` — time series for a named market metric.
/api/v3/market/metrics/:metric_name - GET`GET /api/v3/model-info/releases` — discovered pricing-model releases and last-updated date.
/api/v3/model-info/releases - GET`GET /api/v3/model-info/releases/:model_name` — detail for one pricing-model release.
/api/v3/model-info/releases/:model_name - GET`GET /api/v3/price-index/make-models` — searchable make/model list with price-index coverage.
/api/v3/price-index/make-models - GET`GET /api/v3/price-index/make-models/{make_model_id}/years` — available years for a make/model.
/api/v3/price-index/make-models/:make_model_id/years - GET`GET /api/v3/price-index/timeseries` — historical daily prices with estimate and confidence.
/api/v3/price-index/timeseries?make_model_id=0&year=0 - GET`GET /api/v3/price-index/topline-stats` — aggregate price-index coverage and freshness stats.
/api/v3/price-index/topline-stats - GET`GET /api/v3/price-index/total-data-points` — total predictions and distinct make/model/year combinations.
/api/v3/price-index/total-data-points - GETgetProPortfolioAircraft
/api/v3/pro-portfolio/aircraft/:line_id - PATCHupdateProPortfolioAircraft
/api/v3/pro-portfolio/aircraft/:line_id - GETgetProPortfolioAircraftFlightProfile
/api/v3/pro-portfolio/aircraft/:line_id/flight-profile - GETgetProPortfolioAircraftWebFindings
/api/v3/pro-portfolio/aircraft/:line_id/web-findings - GETlistProPortfolios
/api/v3/pro-portfolio/portfolios - GETlistProPortfolioAircraft
/api/v3/pro-portfolio/portfolios/:portfolio_id/aircraft - GETlistProPortfolioArchive
/api/v3/pro-portfolio/portfolios/:portfolio_id/archive - GETgetProPortfolioAttribution
/api/v3/pro-portfolio/portfolios/:portfolio_id/attribution - GETgetProPortfolioAttributionMonths
/api/v3/pro-portfolio/portfolios/:portfolio_id/attribution/months - GETlistProPortfolioEvents
/api/v3/pro-portfolio/portfolios/:portfolio_id/events - GETgetProPortfolioLending
/api/v3/pro-portfolio/portfolios/:portfolio_id/lending - GETgetProPortfolioOverview
/api/v3/pro-portfolio/portfolios/:portfolio_id/overview - GETgetProPortfolioPositions
/api/v3/pro-portfolio/portfolios/:portfolio_id/positions - GETlistProPortfolioReports
/api/v3/pro-portfolio/portfolios/:portfolio_id/reports - GETlistProPortfolioScenarios
/api/v3/pro-portfolio/portfolios/:portfolio_id/scenarios - GET`GET /api/v3/references/ads` — searchable airworthiness directive catalog.
/api/v3/references/ads - GET`GET /api/v3/references/avionics` — searchable avionics reference catalog.
/api/v3/references/avionics - POST`POST /api/v3/references/avionics/match` — free-text avionics → catalog ids.
/api/v3/references/avionics/matchThe partner-key ("Auto-match") counterpart of the app-session POST /api/app/v1/avionics: an equipment blurb (listing / logbook excerpt) in, deduped {id, make,… - GET`GET /api/v3/references/avionics/prices` — the avionics id → price map the
report renderer uses to value a panel.
/api/v3/references/avionics/pricesReports already publish *cohort* avionics value (typical_avionics_wholesale_value in comparable-aircraft-stats), but the per-unit prices behind it were… - GET`GET /api/v3/references/avionics/:id` — single avionic lookup.
/api/v3/references/avionics/:id - GET`GET /api/v3/references/make-models` — searchable FAA make/model reference catalog.
/api/v3/references/make-models - GET`GET /api/v3/references/make-models/:id` — single make/model lookup.
/api/v3/references/make-models/:id - GET`GET /api/v3/references/stcs` — searchable STC reference catalog.
/api/v3/references/stcs - GET`GET /api/v3/references/tcds` — searchable type certificate data sheet catalog.
/api/v3/references/tcds - GET`GET /api/v3/reports` — list and search reports accessible to the caller.
/api/v3/reports - POST`POST /api/v3/reports` — create a verified value report (requires Pilot Pro or higher).
/api/v3/reports - GET`GET /api/v3/reports/:report_id` — fetch a report; optional `?include=` for
`pricing`, `aircraft`, and `contents` blocks.
/api/v3/reports/:report_id - GET`GET /api/v3/reports/:report_id/aircraft` — aircraft details for the report.
/api/v3/reports/:report_id/aircraft - GET`GET /api/v3/reports/:report_id/comparable-aircraft-stats` — similar-aircraft
cohort stats (hours, time on market, owner tenure) plus avionics rollup.
/api/v3/reports/:report_id/comparable-aircraft-stats - GET`GET /api/v3/reports/:report_id/comparable-sold` — comparable sold-aircraft analysis.
/api/v3/reports/:report_id/comparable-sold - GET`GET /api/v3/reports/{report_id}/diligence` — diligence checklist header
(status, counters, knowledge score). Returns `exists: false` when none exists yet.
/api/v3/reports/:report_id/diligence - POST`POST /api/v3/reports/{report_id}/diligence/generate` — generate (or return
an existing) make/model diligence checklist.
/api/v3/reports/:report_id/diligence/generate - GET`GET /api/v3/reports/{report_id}/diligence/items` — list diligence checklist items.
/api/v3/reports/:report_id/diligence/items - POST`POST /api/v3/reports/{report_id}/diligence/items` — add a diligence checklist item.
/api/v3/reports/:report_id/diligence/items - DELETE`DELETE /api/v3/reports/{report_id}/diligence/items/{item_id}` — remove a
diligence checklist item.
/api/v3/reports/:report_id/diligence/items/:item_id - PATCH`PATCH /api/v3/reports/{report_id}/diligence/items/{item_id}` — update an
item's state, notes, photos, value impact, or fields.
/api/v3/reports/:report_id/diligence/items/:item_id - POST`POST /api/v3/reports/{report_id}/diligence/items/{item_id}/citations` — attach
a citation (`kind`: report_section | logbook_page | link | text).
/api/v3/reports/:report_id/diligence/items/:item_id/citations - DELETE`DELETE /api/v3/reports/{report_id}/diligence/items/{item_id}/citations/{citation_id}` —
remove a citation from an item.
/api/v3/reports/:report_id/diligence/items/:item_id/citations/:citation_id - POST`POST /api/v3/reports/{report_id}/diligence/items/{item_id}/comments` — add a
comment to an item. Body: `{ body }`.
/api/v3/reports/:report_id/diligence/items/:item_id/comments - GET`GET /api/v3/reports/{report_id}/diligence/progress` — completion progress
(counters, knowledge score, and derived metrics).
/api/v3/reports/:report_id/diligence/progress - GET`GET /api/v3/reports/{report_id}/diligence/references` — the full applicable
AD and STC catalogs for the report's make/model, as searchable "tack-on"
indices (each row flags whether it's already on the checklist).
/api/v3/reports/:report_id/diligence/references - POST`POST /api/v3/reports/{report_id}/diligence/regenerate` — regenerate the
diligence checklist from the latest template.
/api/v3/reports/:report_id/diligence/regenerate - GET`GET /api/v3/reports/{report_id}/diligence/suggestions` — suggested diligence checklist items for a report.
/api/v3/reports/:report_id/diligence/suggestions - GET`GET /api/v3/reports/:report_id/download-link` — mint a short-lived, credentialed
URL for the report's generated PDF.
/api/v3/reports/:report_id/download-linkThe PDF lives in Spaces at reports/<owner_id>/<report_id>.pdf (the key report_generator uploads to). The session-authed app route streams those bytes through… - GET`GET /api/v3/reports/:report_id/flight-history` — flight-history analysis for the report.
/api/v3/reports/:report_id/flight-history - GET`GET /api/v3/reports/:report_id/flight-review` — usage comparison of this
aircraft versus its cohort by flight category.
/api/v3/reports/:report_id/flight-review - GET`GET /api/v3/reports/:report_id/interpretability` — pricing-factor breakdown
showing how this aircraft compares to similar aircraft.
/api/v3/reports/:report_id/interpretabilitydata carries factors (each with key, label, pricing_breakdown in dollars, impact_percent and similar_aircraft_impact_percent), a disclaimer (title, body) and… - GET`GET /api/v3/reports/:report_id/logbooks` — structured logbook documents and
pages (summaries, images, transcriptions, processing status).
/api/v3/reports/:report_id/logbooks - POST`POST /api/v3/reports/{report_id}/logbooks` — upload logbook PDFs by URL
for a report (paid add-on).
/api/v3/reports/:report_id/logbooks - GET`GET /api/v3/reports/:report_id/market-strength` — market-strength analysis
(price adjustment and days on market vs. comps).
/api/v3/reports/:report_id/market-strength - GET`GET /api/v3/reports/:report_id/price-timeline` — historical daily prices with
forecast band and trend summary.
/api/v3/reports/:report_id/price-timeline - GET`GET /api/v3/reports/:report_id/pricing` — itemized valuation (estimate,
residual, confidence, appraiser adjustments, and comps).
/api/v3/reports/:report_id/pricing - GETgetReportPrintPreflight
/api/v3/reports/:report_id/print-preflight - GET`GET /api/v3/reports/{report_id}/refresh-subscription` — current auto-refresh
state for the report (subscribed, eligibility, cadence, cap usage). Mirrors
the app-v1 status endpoint. Owner-scoped.
/api/v3/reports/:report_id/refresh-subscription - POST`POST /api/v3/reports/{report_id}/refresh-subscription` — enable daily
auto-refresh for a report.
/api/v3/reports/:report_id/refresh-subscriptionPilot Pro+ only (same gate as report creation). Enforces the per-account bundled cap ([active_subscription_cap]). Idempotent: re-subscribing an already-active… - DELETE`DELETE /api/v3/reports/{report_id}/refresh-subscription` — cancel
auto-refresh (soft-delete). Idempotent.
/api/v3/reports/:report_id/refresh-subscription - PATCH`PATCH /api/v3/reports/{report_id}/refresh-subscription` — pause or resume.
Body: `{ "status": "paused" | "active" }`. Resuming re-checks tier + cap.
/api/v3/reports/:report_id/refresh-subscription - GET`GET /api/v3/reports/:report_id/report-summary` — executive brief (description,
value summary with trends, aircraft and performance specs).
/api/v3/reports/:report_id/report-summaryvalue_summary.likely_range_min / likely_range_max are the 68% range around windsock_value. For a report priced with calibrated ranges they are the valuation… - GET`GET /api/v3/reports/{report_id}/versions` — the report's version history
(newest first). Readable by the owner or any user the report is shared with.
/api/v3/reports/:report_id/versions - GET`GET /api/v3/tracked-aircraft` — the caller's active/paused fleet,
newest-first, with the active-only monthly-cost total.
/api/v3/tracked-aircraft - GET`GET /api/v3/tracked-aircraft/:tracked_aircraft_id` — one tracked aircraft.
/api/v3/tracked-aircraft/:tracked_aircraft_id - GET`GET /api/v3/tracked-aircraft/:id/snapshots` — distinct snapshot dates (`YYYY-MM-DD`) for the aircraft, newest first.
/api/v3/tracked-aircraft/:tracked_aircraft_id/snapshots - GET`GET /api/v3/tracked-aircraft/:id/snapshots/:date` — the latest snapshot
captured on `:date` (a `YYYY-MM-DD` string parsed as a UTC day window).
/api/v3/tracked-aircraft/:tracked_aircraft_id/snapshots/:date - POST`POST /api/v3/underwriting/enrich` — value, ranges, hull-value check, registration, airworthiness and activity for one aircraft. FLEET COMMAND / ENTERPRISE ONLY.
/api/v3/underwriting/enrichOne call per aircraft on a submission. Send a registration (US N-number or an international mark), or make_model_id plus aircraft_info.year. Optional:… - POST`POST /api/v3/underwriting/enrich/batch` — enrich a hull schedule (up to 100 aircraft) and list the insured values outside the ranges. FLEET COMMAND / ENTERPRISE ONLY.
/api/v3/underwriting/enrich/batchBody: { "items": [ ...up to 100 objects shaped like the single enrich body... ], "book_total": false }. Each result carries its index, your reference, and… - GET`GET /api/v3/underwriting/enrichments/{enrichment_id}` — re-serve a stored enrichment exactly as it was first returned.
/api/v3/underwriting/enrichments/:enrichment_idReturns the stored enrichment (including the value and ranges as they stood at the time), so a value bound to a policy can be shown again after a later model… - POST`POST /api/v3/valuations` — point-in-time aircraft valuation with estimate, band, and confidence.
/api/v3/valuations - GETGET /api/v3/zapier/me — Zapier's "test this connection" call.
/api/v3/zapier/me - GETGET /api/v3/zapier/sample/{event} — a representative payload.
/api/v3/zapier/sample/:eventZapier calls this while someone is authoring a Zap, before any real event has happened, so it must return something even for an account with no history.… - POSTPOST /api/v3/zapier/subscribe — a Zap was turned on.
/api/v3/zapier/subscribe - POSTPOST /api/v3/zapier/unsubscribe/{id} — a Zap was turned off.
/api/v3/zapier/unsubscribe/:id
API details
- Base URL
https://windsock.ai- Authentication
- An API key in the X-API-Key header
- Operations
- 124 operations on 116 pathsGET 91POST 27PATCH 3DELETE 3
- Main resources
- v3 124
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
0.1.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
How to test the Windsock in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Windsock collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “`GET /api/v3/account` — current user's plan/tier + the rate-limit matrix.” (GET /api/v3/account), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Windsock?
Aircraft intelligence for developers: valuations with confidence bands, FAA registry lookups and fleet search, cost of ownership, comparable aircraft,… It is listed under Logistics & shipping and has 124 endpoints.
Who publishes the Windsock?
It is listed from Windsock's public API description (an OpenAPI document), not published by Windsock on Swastik Codes. Anyone who controls windsock.ai can claim the profile by adding a DNS TXT record.
What is the base URL of the Windsock?
Requests go to https://windsock.ai. Endpoint paths are added to this base URL.
How do I authenticate with the Windsock?
With an API key in the X-API-Key header.
How many endpoints does the Windsock have?
124 operations on 116 paths (91 GET, 27 POST, 3 PATCH, 3 DELETE). The largest groups are v3.
Is forking the Windsock free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.