{"openapi":"3.1.0","info":{"title":"Visa Atlas public API","version":"2026-07-05","summary":"Open, source-linked skilled-migration data and agent tools.","description":"Machine-readable contract for Visa Atlas public JSON endpoints. Every factual figure is designed to preserve the canonical Visa Atlas URL, the official government source URL and the review date. The data is compiled information, not legal advice.","termsOfService":"https://visaatlas.org/terms","contact":{"name":"Visa Atlas corrections","email":"corrections@visaatlas.org","url":"https://visaatlas.org/corrections"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","servers":[{"url":"https://visaatlas.org"}],"externalDocs":{"description":"Human API reference","url":"https://visaatlas.org/api"},"tags":[{"name":"Catalog","description":"Dataset and API discovery surfaces."},{"name":"Reference datasets","description":"Lookup, route, policy and citation-support datasets."},{"name":"Figure datasets","description":"Numeric and derived datasets with source URLs and review dates."},{"name":"Agent tools","description":"Profile-specific, read-only tools over the same source-linked data layer."}],"paths":{"/api/openapi.json":{"get":{"tags":["Catalog"],"operationId":"getOpenApiDocument","summary":"OpenAPI document","description":"Machine-readable OpenAPI 3.1 contract for public Visa Atlas JSON endpoints.","responses":{"200":{"description":"OpenAPI 3.1 document.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OpenApiDocument"}}}}}}},"/api/public":{"get":{"tags":["Catalog"],"operationId":"getPublicDatasetCatalog","summary":"Public dataset catalog","description":"Self-describing public dataset catalog with schema.org Dataset metadata and DataDownload URLs for every static public dataset.","externalDocs":{"description":"Human catalog documentation","url":"https://visaatlas.org/api#catalog"},"responses":{"200":{"description":"Public dataset catalog.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublicDatasetCatalog"}}}}}}},"/api/public/visas":{"get":{"tags":["Reference datasets"],"operationId":"getVisas","summary":"Visa routes","description":"Every indexed visa and residence route, with category, sponsorship, settlement, summary, primary source and review date. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#visas"},"responses":{"200":{"description":"Visa routes JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":1414,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/visas","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/destinations":{"get":{"tags":["Reference datasets"],"operationId":"getDestinations","summary":"Destinations","description":"Indexable destination countries and territories, with official immigration portals and advice regulators. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#destinations"},"responses":{"200":{"description":"Destinations JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":233,"x-date-modified":"2026-06-30","x-human-path":"https://visaatlas.org/visas","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/policy-updates":{"get":{"tags":["Reference datasets"],"operationId":"getPolicyUpdates","summary":"Policy updates","description":"Dated, source-linked immigration policy changes with severity, claims, affected routes and review dates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#policy-updates"},"responses":{"200":{"description":"Policy updates JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":37,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/policy-updates","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/policy-claims":{"get":{"tags":["Reference datasets"],"operationId":"getPolicyClaims","summary":"Policy update claims","description":"One source-backed, stable-url record for each atomic immigration policy claim, linked to the policy update page, affected routes and supporting source. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#policy-claims"},"responses":{"200":{"description":"Policy update claims JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":115,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/policy-updates","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/citation-packs":{"get":{"tags":["Reference datasets"],"operationId":"getCitationPacks","summary":"Immigration citation packs","description":"Concise, source-linked answer packets for AI retrievers, journalists, researchers and auditors, each with canonical page URL, dataset URL, facts, sources, date modified, license and suggested citation. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#citation-packs"},"responses":{"200":{"description":"Immigration citation packs JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CitationPacksResponse"}}}}},"x-record-count":162,"x-date-modified":"2026-07-06","x-human-path":"https://visaatlas.org/citation-packs","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/answer-capsules":{"get":{"tags":["Reference datasets"],"operationId":"getAnswerCapsules","summary":"Verified answer capsules","description":"Question-answer records extracted from rendered Visa Atlas verified-answer blocks, each with canonical page URL, source URLs, dataset URLs, date modified, license and legal note. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#answer-capsules"},"responses":{"200":{"description":"Verified answer capsules JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnswerCapsulesResponse"}}}}},"x-record-count":292,"x-date-modified":"2026-07-06","x-human-path":"https://visaatlas.org/answer-capsules","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/citation-benchmark":{"get":{"tags":["Reference datasets"],"operationId":"getCitationBenchmark","summary":"AI citation benchmark","description":"Fixed high-intent skilled-migration question basket used to measure whether answer engines cite Visa Atlas for source-backed immigration questions. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#citation-benchmark"},"responses":{"200":{"description":"AI citation benchmark JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":48,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/citation-benchmark","x-primary-source-note":"Each benchmark prompt points to source-linked Visa Atlas pages and datasets; 7 high-risk prompts also publish conservative answer-key facts for offline accuracy triage."}},"/api/public/ai-retrieval-task-index":{"get":{"tags":["Reference datasets"],"operationId":"getAiRetrievalTaskIndex","summary":"AI retrieval task index","description":"Query-level retrieval contract joining benchmark immigration questions to canonical pages, answer capsules, citation packs, calculator contexts, SEO/GEO page actions, competitor battlecards, MCP tools and safe-answer rules. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#ai-retrieval-task-index"},"responses":{"200":{"description":"AI retrieval task index JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":48,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/ai-retrieval-task-index-2026","x-primary-source-note":"This is a public retrieval and citation map, not proof of rankings, traffic, AI citations, live market share or 500k/month. Raw AI transcripts, Search Console queries, SERP screenshots, analytics, referral logs and reviewer evidence remain local unless separately reviewed and aggregated."}},"/api/public/ai-retrieval-readiness":{"get":{"tags":["Reference datasets"],"operationId":"getAiRetrievalReadiness","summary":"AI retrieval readiness scorecard","description":"Prompt-level gap scorecard ranking AI citation benchmark tasks by answer capsule, citation pack, page action, battlecard, calculator context, MCP tool depth and evidence-gate coverage. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#ai-retrieval-readiness"},"responses":{"200":{"description":"AI retrieval readiness scorecard JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":48,"x-date-modified":"2026-07-05","x-human-path":"https://visaatlas.org/research/ai-retrieval-readiness-scorecard-2026","x-primary-source-note":"This is a public retrieval-asset coverage scorecard, not proof of rankings, traffic, AI citations, live market share or 500k/month. Raw AI transcripts, Search Console queries, SERP screenshots, analytics, referral logs and reviewer evidence remain local unless separately reviewed and aggregated."}},"/api/public/ai-answer-accuracy-audit":{"get":{"tags":["Reference datasets"],"operationId":"getAiAnswerAccuracyAudit","summary":"AI answer accuracy audit protocol","description":"Public protocol for grading high-risk AI immigration answers against source-backed Visa Atlas facts, with answer-key coverage, stale-claim traps, local commands and publication guardrails. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#ai-answer-accuracy-audit"},"responses":{"200":{"description":"AI answer accuracy audit protocol JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":7,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/ai-answer-accuracy-audit-2026","x-primary-source-note":"Rows are derived from the public AI citation benchmark and its high-risk answer key; raw model outputs and unreviewed engine grades stay local until separately reviewed."}},"/api/public/source-transparency-benchmark":{"get":{"tags":["Reference datasets"],"operationId":"getSourceTransparencyBenchmark","summary":"Immigration source-transparency benchmark","description":"Sampled competitor/source-class benchmark comparing public immigration-information surfaces against source transparency, freshness, open-data and AI-retrieval criteria. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#source-transparency-benchmark"},"responses":{"200":{"description":"Immigration source-transparency benchmark JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":7,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/immigration-source-transparency-benchmark-2026","x-primary-source-note":"The benchmark records what was visible in sampled public pages and exposes recrawl due dates; overdue samples cannot support wedge or market-share claims. It is a public-surface comparison, not a full-site forensic audit."}},"/api/public/visibility-metrics":{"get":{"tags":["Reference datasets"],"operationId":"getVisibilityMetrics","summary":"SEO/GEO visibility metrics","description":"Public measurement contract separating Google organic growth, AI citation share, crawler access, source freshness, index quality and technical trust gates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#visibility-metrics"},"responses":{"200":{"description":"SEO/GEO visibility metrics JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":9,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/visibility-metrics","x-primary-source-note":"This is a public measurement contract and planning model; it does not expose private analytics or claim current traffic."}},"/api/public/traffic-forecast":{"get":{"tags":["Reference datasets"],"operationId":"getTrafficForecast","summary":"SEO/GEO traffic forecast model","description":"Falsifiable cohort-level planning model for the Visa Atlas 500k/month SEO/GEO target, with ranges, assumptions, measurement commands and kill gates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#traffic-forecast"},"responses":{"200":{"description":"SEO/GEO traffic forecast model JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":5,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/seo-geo-traffic-forecast-2026","x-primary-source-note":"This is a planning forecast, not current analytics. Actual sessions, Search Console rows and outcome evidence remain local unless separately reviewed and aggregated."}},"/api/public/technical-seo-controls":{"get":{"tags":["Reference datasets"],"operationId":"getTechnicalSeoControls","summary":"Technical SEO/GEO control matrix","description":"Audit-ready control matrix for rendering, indexability, schema, open-data discovery, AI retrieval, freshness, performance and private-evidence boundaries behind the SEO/GEO plan. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#technical-seo-controls"},"responses":{"200":{"description":"Technical SEO/GEO control matrix JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":9,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/technical-seo-control-plane-2026","x-primary-source-note":"This is a technical control matrix, not a ranking or traffic claim. Private analytics, Search Console exports, server logs and outcome evidence remain local unless separately reviewed and aggregated."}},"/api/public/topical-authority-map":{"get":{"tags":["Reference datasets"],"operationId":"getTopicalAuthorityMap","summary":"Topical authority and internal-link map","description":"Audit-ready hub-and-spoke map for SEO/GEO crawl paths: topical clusters, canonical hubs, supporting pages, anchor rules, crawl entry points and evidence commands. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#topical-authority-map"},"responses":{"200":{"description":"Topical authority and internal-link map JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":7,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/topical-authority-internal-link-map-2026","x-primary-source-note":"This is a crawl-path and internal-link control map, not a ranking or traffic claim. Private analytics, Search Console exports, server logs and experiment rows remain local unless separately reviewed and aggregated."}},"/api/public/seo-geo-audit-evidence":{"get":{"tags":["Reference datasets"],"operationId":"getSeoGeoAuditEvidence","summary":"SEO/GEO audit evidence pack","description":"Big-4-style evidence pack mapping the SEO/GEO dominance plan to public controls, local evidence workflows, external evidence needs, pass criteria and private-data boundaries. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#seo-geo-audit-evidence"},"responses":{"200":{"description":"SEO/GEO audit evidence pack JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":12,"x-date-modified":"2026-07-05","x-human-path":"https://visaatlas.org/research/seo-geo-audit-evidence-pack-2026","x-primary-source-note":"This is an audit evidence matrix, not proof of current traffic, rankings, citations, backlinks or market share. Raw analytics, Search Console exports, server logs, AI transcripts, outreach records and reviewer evidence remain local unless separately reviewed and aggregated."}},"/api/public/execution-readiness":{"get":{"tags":["Reference datasets"],"operationId":"getExecutionReadiness","summary":"SEO/GEO execution readiness scorecard","description":"Cohort-level execution scorecard tying the 500k/month SEO/GEO plan to content pieces, page changes, technical gates, competitor wedges, private evidence needs and no-go conditions. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#execution-readiness"},"responses":{"200":{"description":"SEO/GEO execution readiness scorecard JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":5,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/seo-geo-execution-readiness-scorecard-2026","x-primary-source-note":"This is a readiness scorecard, not proof of current traffic, rankings, AI citations, backlinks or market share. Raw analytics, Search Console exports, AI outputs, SERP screenshots, bot logs, outreach records and reviewer notes stay local unless separately reviewed and aggregated."}},"/api/public/market-share-capture-plan":{"get":{"tags":["Reference datasets"],"operationId":"getMarketShareCapturePlan","summary":"SEO/GEO market-share capture plan","description":"Battlecard-level capture plan tying competitor wedges to content pieces, page changes, technical changes, production tickets, evidence commands, private evidence needs and no-go gates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#market-share-capture-plan"},"responses":{"200":{"description":"SEO/GEO market-share capture plan JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/market-share-capture-plan-2026","x-primary-source-note":"This is a market-share capture plan, not proof of current rankings, traffic, AI citations, backlinks, live market share or 500k/month. Raw Search Console exports, SERP screenshots, AI transcripts, analytics rows and unapproved rollups remain local unless separately reviewed and aggregated."}},"/api/public/seo-geo-production-queue":{"get":{"tags":["Reference datasets"],"operationId":"getSeoGeoProductionQueue","summary":"SEO/GEO production queue","description":"Flat ticket queue derived from the market-share capture plan, exposing content, page, technical and evidence workstreams with owners, target pages, commands, source datasets, evidence gates and no-go conditions. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#seo-geo-production-queue"},"responses":{"200":{"description":"SEO/GEO production queue JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":52,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/seo-geo-production-queue-2026","x-primary-source-note":"This is a public production queue, not proof of current rankings, traffic, AI citations, backlinks, live market share or 500k/month. Raw analytics, Search Console exports, SERP screenshots, AI transcripts and unapproved rollups remain local unless separately reviewed and aggregated."}},"/api/public/seo-geo-page-action-map":{"get":{"tags":["Reference datasets"],"operationId":"getSeoGeoPageActionMap","summary":"SEO/GEO page action map","description":"Page-level join table mapping SEO/GEO target URLs to production tickets, battlecards, SERP/AI handoff briefs, search-demand actions, answer capsules, citation packs, calculator contexts, source datasets, local commands and audit gates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#seo-geo-page-action-map"},"responses":{"200":{"description":"SEO/GEO page action map JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":118,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/seo-geo-page-action-map-2026","x-primary-source-note":"This is public relationship metadata for production control, not proof of current rankings, traffic, AI citations, backlinks, live market share or 500k/month. Raw analytics, Search Console exports, SERP screenshots, AI transcripts and unapproved rollups remain local unless separately reviewed and aggregated."}},"/api/public/battlecard-retrieval-coverage":{"get":{"tags":["Reference datasets"],"operationId":"getBattlecardRetrievalCoverage","summary":"Battlecard retrieval coverage matrix","description":"Battlecard-level coverage matrix joining competitor query clusters to target pages, page-action rows, answer surfaces, citation packs, AI retrieval prompts, experiments, snapshot protocols and evidence gates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#battlecard-retrieval-coverage"},"responses":{"200":{"description":"Battlecard retrieval coverage matrix JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-06","x-human-path":"https://visaatlas.org/research/battlecard-retrieval-coverage-matrix-2026","x-primary-source-note":"This is a public retrieval-asset coverage matrix, not proof of current rankings, traffic, AI citations, backlinks, live market share or 500k/month. Raw analytics, Search Console exports, SERP screenshots, AI transcripts and unapproved rollups remain local unless separately reviewed and aggregated."}},"/api/public/seo-geo-dominance-gap-ledger":{"get":{"tags":["Reference datasets"],"operationId":"getSeoGeoDominanceGapLedger","summary":"SEO/GEO dominance gap ledger","description":"Battlecard-level blocker ledger joining public retrieval coverage, content/page/technical work, competitor pressure, reviewer queues, authority distribution and outcome-proof gates for the 500k/month plan. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#seo-geo-dominance-gap-ledger"},"responses":{"200":{"description":"SEO/GEO dominance gap ledger JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-06","x-human-path":"https://visaatlas.org/research/seo-geo-dominance-gap-ledger-2026","x-primary-source-note":"This endpoint identifies remaining blockers to durable SEO/GEO dominance. It does not prove current rankings, traffic, AI citations, backlinks, market share or 500k/month; raw outcome evidence remains local unless reviewed and aggregated."}},"/api/public/seo-geo-measurement-run-queue":{"get":{"tags":["Reference datasets"],"operationId":"getSeoGeoMeasurementRunQueue","summary":"SEO/GEO measurement run queue","description":"Battlecard-level run queue joining dominance blockers to private GSC experiments, SERP/AI snapshots, reviewer proof, authority proof, AI visibility, market-share and traffic outcome proof workflows. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#seo-geo-measurement-run-queue"},"responses":{"200":{"description":"SEO/GEO measurement run queue JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-06","x-human-path":"https://visaatlas.org/research/seo-geo-measurement-run-queue-2026","x-primary-source-note":"This endpoint publishes execution metadata and approval gates. It is not proof of rankings, traffic, AI citations, backlinks, reviewer trust, market share or 500k/month; raw evidence stays local unless reviewed and aggregated."}},"/api/public/search-demand-actions":{"get":{"tags":["Reference datasets"],"operationId":"getSearchDemandActions","summary":"Search demand action map","description":"Audit-ready decision matrix for turning local GSC, SERP and AI answer-surface evidence into content, page and technical SEO/GEO actions without publishing private query data. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#search-demand-actions"},"responses":{"200":{"description":"Search demand action map JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":7,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/research/search-demand-action-map-2026","x-primary-source-note":"This endpoint publishes action rules only. Raw Search Console exports, query strings, clicks, impressions, CTR, positions, screenshots and AI transcripts stay local unless reviewed, redacted and aggregated."}},"/api/public/crawler-access":{"get":{"tags":["Reference datasets"],"operationId":"getCrawlerAccess","summary":"Crawler and AI retrieval access audit","description":"Public audit of the robots policy, crawler-facing discovery surfaces, JSON headers and local log commands that let search and AI retrievers access Visa Atlas. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#crawler-access"},"responses":{"200":{"description":"Crawler and AI retrieval access audit JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":25,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/crawler-ai-retrieval-access-audit-2026","x-primary-source-note":"This endpoint proves access intent and discovery wiring, not live crawler fetches, rankings, citations or traffic; server logs and Search Console remain local proof sources."}},"/api/public/authority-distribution-plan":{"get":{"tags":["Reference datasets"],"operationId":"getAuthorityDistributionPlan","summary":"Authority distribution plan","description":"Auditable distribution control plane for turning Visa Atlas open data, MCP tools, widgets and original research into off-site citations, links, dataset entities and AI retriever entry points. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#authority-distribution-plan"},"responses":{"200":{"description":"Authority distribution plan JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":11,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/authority-distribution-plan-2026","x-primary-source-note":"This endpoint publishes launch readiness, local commands and evidence fields; it does not claim completed third-party publication, backlinks, rankings, citations or traffic."}},"/api/public/widgets":{"get":{"tags":["Reference datasets"],"operationId":"getWidgets","summary":"Embeddable widget catalog","description":"Machine-readable catalog of approved Visa Atlas embed scripts for sourced immigration figures and calculators, with source trails, attribution rules and legal-scope guardrails. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#widgets"},"responses":{"200":{"description":"Embeddable widget catalog JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":32,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/widgets","x-primary-source-note":"The catalog proves approved public embed inventory and source trails; it does not prove third-party publication, backlinks, rankings, citations or traffic."}},"/api/public/content-opportunities":{"get":{"tags":["Reference datasets"],"operationId":"getContentOpportunities","summary":"SEO/GEO content opportunity map","description":"Auditable priority map for the content pieces, page work and technical changes that support the Visa Atlas 500k/month SEO/GEO plan, with competitor wedge notes and evidence surfaces. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#content-opportunities"},"responses":{"200":{"description":"SEO/GEO content opportunity map JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":28,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/seo-geo-content-opportunity-map-2026","x-primary-source-note":"This is a roadmap and prioritisation dataset, not a current-traffic claim or ranking guarantee. Planned rows still require source verification before publication."}},"/api/public/competitor-query-battlecards":{"get":{"tags":["Reference datasets"],"operationId":"getCompetitorQueryBattlecards","summary":"Competitor query battlecards","description":"Auditable SEO/GEO battlecards mapping high-intent immigration query clusters to sampled competitor archetypes, checked public evidence URLs, Visa Atlas wedge moves, strategic positioning rollups, target pages, retrieval playbooks, crawl-path and indexability assurance, source datasets and measurement commands. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#competitor-query-battlecards"},"responses":{"200":{"description":"Competitor query battlecards JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-05","x-human-path":"https://visaatlas.org/research/competitor-query-battlecards-2026","x-primary-source-note":"Battlecards and positioning rollups are compiled from the sampled source-transparency benchmark, fixed AI citation benchmark and visibility measurement contract; sampled competitor observations carry recrawl metadata and are planning guidance, not ranking, traffic or market-share guarantees."}},"/api/public/battlecard-search-experiments":{"get":{"tags":["Reference datasets"],"operationId":"getBattlecardSearchExperiments","summary":"Battlecard search experiments","description":"Public experiment contract for converting competitor query battlecards into Search Console-measured title, snippet, answer-capsule and internal-link tests while keeping private GSC exports local. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#battlecard-search-experiments"},"responses":{"200":{"description":"Battlecard search experiments JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/battlecard-search-experiments-2026","x-primary-source-note":"Rows are public experiment templates and matching rules derived from competitor battlecards; raw Search Console exports and outcomes remain local private measurement data."}},"/api/public/serp-answer-surface-snapshots":{"get":{"tags":["Reference datasets"],"operationId":"getSerpAnswerSurfaceSnapshots","summary":"SERP and AI answer-surface snapshot protocol","description":"Auditable protocol for capturing Google SERP features, competitor source classes and AI answer citations by battlecard query while keeping raw screenshots, transcripts and private reviewer notes local. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#serp-answer-surface-snapshots"},"responses":{"200":{"description":"SERP and AI answer-surface snapshot protocol JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/serp-answer-surface-snapshots-2026","x-primary-source-note":"This endpoint publishes capture protocol and redaction rules, not current SERP rankings, private screenshots, raw AI answer transcripts or live market-share claims."}},"/api/public/quarterly-market-share-summary":{"get":{"tags":["Reference datasets"],"operationId":"getQuarterlyMarketShareSummary","summary":"Quarterly market-share evidence summary","description":"Q3 2026 baseline and local rollup contract for summarising reviewed SERP and AI answer-surface evidence by competitor query battlecard without publishing raw private evidence. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#quarterly-market-share-summary"},"responses":{"200":{"description":"Quarterly market-share evidence summary JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-05","x-human-path":"https://visaatlas.org/research/quarterly-market-share-evidence-summary-2026","x-primary-source-note":"This endpoint publishes baseline rows and a local rollup contract. It does not claim current market share until reviewed redacted snapshot evidence is supplied."}},"/api/public/publisher-citation-kits":{"get":{"tags":["Reference datasets"],"operationId":"getPublisherCitationKits","summary":"Publisher and AI-citation kits","description":"Reusable citation and outreach kits for publishers, journalists, researchers and AI retrievers, with canonical URLs, source datasets, attribution snippets and private evidence-log rules. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#publisher-citation-kits"},"responses":{"200":{"description":"Publisher and AI-citation kits JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":7,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/publisher-citation-kits-2026","x-primary-source-note":"This endpoint publishes reusable citation kits and local evidence-log rules. It does not publish private outreach contacts, replies, notes or backlink guarantees."}},"/api/public/external-repository-mirrors":{"get":{"tags":["Reference datasets"],"operationId":"getExternalRepositoryMirrors","summary":"External repository mirror manifest","description":"Repository-ready export manifests, metadata templates, DOI/accession checklists and canonical backlink requirements for mirroring original Visa Atlas datasets into external data repositories. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#external-repository-mirrors"},"responses":{"200":{"description":"External repository mirror manifest JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":6,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/research/external-data-repository-mirrors-2026","x-primary-source-note":"This endpoint publishes repository mirror readiness, template export commands and evidence-log rules. It does not claim external repository publication until approved URL or DOI evidence is reviewed."}},"/api/public/knowledge-graph-entities":{"get":{"tags":["Reference datasets"],"operationId":"getKnowledgeGraphEntities","summary":"Knowledge-graph entity seeding manifest","description":"Auditable entity-seeding controls for source-backed datasets, reports and organization nodes, including sameAs governance, approved external accession ingestion and local knowledge-graph evidence logging. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#knowledge-graph-entities"},"responses":{"200":{"description":"Knowledge-graph entity seeding manifest JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":9,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/knowledge-graph-entity-seeding-2026","x-primary-source-note":"This endpoint publishes candidate entities and identifier governance. It does not add Wikidata QIDs, DOI/accession values or sameAs URLs to public JSON-LD without approved evidence."}},"/api/public/expert-reviewer-entities":{"get":{"tags":["Reference datasets"],"operationId":"getExpertReviewerEntities","summary":"Expert reviewer entity program","description":"Reviewer disclosure model for YMYL immigration pages, including source-editor limits, regulated reviewer slots, reviewedBy schema governance and local credential evidence logging. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#expert-reviewer-entities"},"responses":{"200":{"description":"Expert reviewer entity program JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":13,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/expert-reviewer-entity-program-2026","x-primary-source-note":"This endpoint publishes reviewer slots, source-editor limits and review queues. It does not publish private reviewer contacts or emit reviewedBy schema without approved credential evidence."}},"/api/public/reviewedby-schema-rollout":{"get":{"tags":["Reference datasets"],"operationId":"getReviewedbySchemaRollout","summary":"reviewedBy schema rollout controls","description":"Schema emission controls for page-level reviewedBy JSON-LD fragments, gated by approved reviewer evidence rows and offline export review before publication. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#reviewedby-schema-rollout"},"responses":{"200":{"description":"reviewedBy schema rollout controls JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":6,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/reviewedby-schema-rollout-2026","x-primary-source-note":"This endpoint publishes rollout controls and evidence requirements. It does not claim reviewedBy schema is live and does not publish private reviewer contacts or unapproved credentials."}},"/api/public/high-risk-page-review-acquisition":{"get":{"tags":["Reference datasets"],"operationId":"getHighRiskPageReviewAcquisition","summary":"High-risk page review acquisition controls","description":"Reviewer sourcing, vetting and handoff controls for high-risk YMYL immigration page queues, with local-only candidate evidence and no public reviewer claims until approved handoff. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#high-risk-page-review-acquisition"},"responses":{"200":{"description":"High-risk page review acquisition controls JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":6,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/high-risk-page-review-acquisition-2026","x-primary-source-note":"This endpoint publishes acquisition targets, regulator requirements and handoff controls. It does not publish private reviewer leads or claim completed reviews."}},"/api/public/p0-reviewed-page-refresh":{"get":{"tags":["Reference datasets"],"operationId":"getP0ReviewedPageRefresh","summary":"P0 reviewed page refresh controls","description":"Publication gates for refreshing P0 YMYL pages after reviewer handoff evidence, with local-only reviewer notes, content-diff evidence and reviewedBy schema checks blocked by default. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#p0-reviewed-page-refresh"},"responses":{"200":{"description":"P0 reviewed page refresh controls JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":3,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/p0-reviewed-page-refresh-2026","x-primary-source-note":"This endpoint publishes publication gates and evidence requirements. It does not publish reviewer notes or claim completed page reviews."}},"/api/public/calculator-verdict-contexts":{"get":{"tags":["Reference datasets"],"operationId":"getCalculatorVerdictContexts","summary":"Calculator verdict contexts","description":"Dated cutoff, salary-threshold and proof-of-funds context for high-intent immigration calculators, so calculator outputs can be interpreted against current source-backed figures. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#calculator-verdict-contexts"},"responses":{"200":{"description":"Calculator verdict contexts JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":10,"x-date-modified":"2026-07-04","x-human-path":"https://visaatlas.org/calculators","x-primary-source-note":"Each calculator context links to the current source-backed draw, salary-threshold or proof-of-funds dataset. The context helps interpret calculator outputs; it is not a decision or outcome prediction."}},"/api/public/indexable-pages":{"get":{"tags":["Reference datasets"],"operationId":"getIndexablePages","summary":"Indexable page manifest","description":"Audit mirror of the XML sitemap: every indexable Visa Atlas URL classified by page cohort, priority, change frequency, freshness date and source-dataset pointers. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#indexable-pages"},"responses":{"200":{"description":"Indexable page manifest JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndexablePageManifest"}}}}},"x-record-count":7374,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/data#indexable-pages","x-primary-source-note":"Rows are generated from the same sitemap builder as /sitemap.xml; this is an indexability-intent manifest, not a live crawl or ranking claim."}},"/api/public/search-index":{"get":{"tags":["Reference datasets"],"operationId":"getSearchIndex","summary":"Public site search index","description":"Compact title, description, kind, keyword and URL map for Visa Atlas searchable destinations, visa routes, nationality hubs, calculators, data pages, research reports, policy updates, editorial routes, rankings and best-of guides. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#search-index"},"responses":{"200":{"description":"Public site search index JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":1983,"x-date-modified":"2026-07-03","x-human-path":"https://visaatlas.org/search","x-primary-source-note":"Rows are generated from typed Visa Atlas route, destination, navigation, calculator, cost, salary, processing, settlement and policy data plus curated strategic research pages; sourceDatasets identify the public JSON feeds that best audit each row."}},"/api/public/freshness":{"get":{"tags":["Reference datasets"],"operationId":"getFreshness","summary":"Source freshness report","description":"Public freshness/SLA report over every dated Visa Atlas source record, including processing-time figures, fees, cost-to-complete models, salary thresholds, route narratives, settlement pathways and policy updates. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#freshness"},"responses":{"200":{"description":"Source freshness report JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":1674,"x-date-modified":"2026-07-06","x-human-path":"https://visaatlas.org/freshness","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/processing-reliability":{"get":{"tags":["Figure datasets"],"operationId":"getProcessingReliability","summary":"Processing-time planning reliability index","description":"Derived index scoring how usable each official immigration processing-time clock is for planning, based on clock availability, window width, percentile disclosure and source freshness. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#processing-reliability"},"responses":{"200":{"description":"Processing-time planning reliability index JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":98,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/research/processing-time-reliability-index-2026","x-primary-source-note":"Scores are derived from the source-linked processing-times dataset; the index measures planning transparency, not individual case outcomes."}},"/api/public/skilled-migration-accessibility":{"get":{"tags":["Figure datasets"],"operationId":"getSkilledMigrationAccessibility","summary":"Skilled-migration planning accessibility index","description":"Derived index scoring tracked skilled and skilled-adjacent migration routes by planning accessibility across cost, proof-of-funds exposure, salary floor, processing-clock transparency, sponsor requirement, settlement path and source freshness. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#skilled-migration-accessibility"},"responses":{"200":{"description":"Skilled-migration planning accessibility index JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":30,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/research/skilled-migration-accessibility-index-2026","x-primary-source-note":"Scores are derived from source-linked route, cost, salary and processing datasets; the index measures planning friction, not eligibility or individual outcomes."}},"/api/public/country-comparisons":{"get":{"tags":["Figure datasets"],"operationId":"getCountryComparisons","summary":"Country comparison data","description":"Machine-readable inventory of indexable country comparison pages, with destination profiles and pair-level trade-off metrics derived from source-linked route, salary, processing, cost and policy datasets. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#country-comparisons"},"responses":{"200":{"description":"Country comparison data JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":3192,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/compare","x-primary-source-note":"Rows are derived from existing source-linked public datasets and rendered compare-page rules; this is not legal advice or a recommendation to choose one country over another."}},"/api/public/fees":{"get":{"tags":["Figure datasets"],"operationId":"getFees","summary":"Visa and immigration fees","description":"Government-published fee breakdowns by destination and visa route, with per-line amounts, currencies and a worked example for the headline case. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#fees"},"responses":{"200":{"description":"Visa and immigration fees JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":37,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/fees","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/cost-to-complete":{"get":{"tags":["Figure datasets"],"operationId":"getCostToComplete","summary":"Visa cost-to-complete models","description":"All-in route cost models separating mandatory non-refundable costs from refundable proof-of-funds requirements, with each line item sourced or marked indicative. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#cost-to-complete"},"responses":{"200":{"description":"Visa cost-to-complete models JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":30,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/cost-to-complete","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/salary-thresholds":{"get":{"tags":["Figure datasets"],"operationId":"getSalaryThresholds","summary":"Salary thresholds","description":"Minimum-salary thresholds by destination, grouped into 21 destination blocks covering 61 individual route thresholds, each with local-currency amount, basis and effective date. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#salary-thresholds"},"responses":{"200":{"description":"Salary thresholds JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":21,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/salary-thresholds","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/processing-times":{"get":{"tags":["Figure datasets"],"operationId":"getProcessingTimes","summary":"Processing times","description":"Typical decision-time bands by destination and visa route, drawn from each issuing authority where it publishes one. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#processing-times"},"responses":{"200":{"description":"Processing times JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":98,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/processing-times","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/express-entry-draws":{"get":{"tags":["Figure datasets"],"operationId":"getExpressEntryDraws","summary":"Canada Express Entry draws","description":"Round-by-round history of Canada Express Entry invitations, with category, invitations issued and CRS cut-off score, confirmed against IRCC. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#express-entry-draws"},"responses":{"200":{"description":"Canada Express Entry draws JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":37,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/canada-express-entry-draw-tracker","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/express-entry-categories":{"get":{"tags":["Figure datasets"],"operationId":"getExpressEntryCategories","summary":"Canada Express Entry categories","description":"Derived tracker for IRCC category-based Express Entry selection: current categories, categories with 2026 draws, categories without a 2026 draw, invitations and CRS ranges. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#express-entry-categories"},"responses":{"200":{"description":"Canada Express Entry categories JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":10,"x-date-modified":"2026-07-02","x-human-path":"https://visaatlas.org/research/canada-express-entry-category-tracker","x-primary-source-note":"Rows are derived from IRCC draw records and IRCC category-based selection guidance; category eligibility does not guarantee an invitation."}},"/api/public/fact-changes":{"get":{"tags":["Figure datasets"],"operationId":"getFactChanges","summary":"Rules and threshold fact changes","description":"Machine-readable diff feed of every recorded fee, salary-threshold and processing-time movement, with stable fact IDs, old/new values, effective dates, current owning route and primary source. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#fact-changes"},"responses":{"200":{"description":"Rules and threshold fact changes JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":7,"x-date-modified":"2026-03-01","x-human-path":"https://visaatlas.org/changelog","x-primary-source-note":"Every figure links to its official government primary source. Always confirm against the source before relying on it."}},"/api/public/monthly-figure-changes":{"get":{"tags":["Figure datasets"],"operationId":"getMonthlyFigureChanges","summary":"Monthly immigration figure changes","description":"Month-by-month archive of recorded fee, salary-threshold and processing-time movements, with old value, new value, owning page, source URL and same-month policy context. Reuse under CC BY 4.0 with attribution to Visa Atlas; keep official source URLs and review dates with copied figures.","externalDocs":{"description":"Field reference and examples","url":"https://visaatlas.org/api#monthly-figure-changes"},"responses":{"200":{"description":"Monthly immigration figure changes JSON response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-record-count":5,"x-date-modified":"2026-07-01","x-human-path":"https://visaatlas.org/research/monthly-immigration-figure-changes","x-primary-source-note":"Rows are derived from the source-linked fact-change feed; this is an archive of recorded Visa Atlas figure movements, not a complete global census of policy changes."}},"/api/public/route-finder":{"get":{"tags":["Agent tools"],"operationId":"getRouteFinderContract","summary":"Route finder contract","description":"Returns the route-finder request schema, legal caveats, methodology and a working example response.","externalDocs":{"description":"Human route finder","url":"https://visaatlas.org/triage"},"responses":{"200":{"description":"Route-finder contract and example.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteFinderContract"}}}}}},"post":{"tags":["Agent tools"],"operationId":"findRoutes","summary":"Find matching visa routes","description":"Deterministic profile-to-route matching over indexable Visa Atlas visa routes, returning ranked route candidates with canonical pages, source URLs and review dates.","externalDocs":{"description":"Human route finder","url":"https://visaatlas.org/triage"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteFinderRequest"}}}},"responses":{"200":{"description":"Ranked route candidates with source trails.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RouteFinderResponse"}}}},"400":{"description":"Invalid request body.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"x-legal-note":"Informational route matching only, not legal advice or an eligibility decision. Confirm the returned route against the linked government source and, where needed, a qualified immigration adviser.","x-version":"2026-07-03"}},"/mcp":{"post":{"tags":["Agent tools"],"operationId":"callMcpJsonRpc","summary":"Read-only MCP endpoint","description":"Streamable HTTP MCP endpoint for read-only provenance-out tools. Use MCP tool discovery for exact JSON-RPC payloads; this OpenAPI entry advertises the endpoint for crawlers and governance reviews.","externalDocs":{"description":"AI-agent retrieval contract","url":"https://visaatlas.org/ai-agents"},"responses":{"200":{"description":"MCP JSON-RPC response.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}},"405":{"description":"Unsupported method.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenericJsonResponse"}}}}},"x-mcp-tools":["get_fee","get_cost_to_complete","get_salary_thresholds","get_processing_time","list_express_entry_draws","find_routes","list_answer_capsules","list_citation_packs","list_calculator_verdict_contexts","list_competitor_battlecards","list_market_share_capture_plan","list_seo_geo_production_queue","list_seo_geo_page_action_map","list_seo_geo_dominance_gap_ledger","list_seo_geo_measurement_run_queue","list_high_risk_review_acquisition_targets","list_authority_distribution_channels","list_ai_retrieval_tasks","list_ai_retrieval_readiness","list_fact_changes","list_policy_updates","list_policy_claims"]}}},"components":{"schemas":{"OpenApiDocument":{"type":"object","required":["openapi","info","paths"],"properties":{"openapi":{"type":"string"},"info":{"type":"object"},"paths":{"type":"object"}}},"GenericJsonResponse":{"type":"object","additionalProperties":true,"description":"Endpoint-specific JSON. See the human API reference and each endpoint example for the stable field set."},"PublicDatasetCatalog":{"type":"object","required":["datasets","catalogJsonld","jsonld"],"properties":{"datasets":{"type":"array","items":{"$ref":"#/components/schemas/PublicDataset"}},"catalogJsonld":{"$ref":"#/components/schemas/DataCatalogJsonLd"},"jsonld":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"DataCatalogJsonLd":{"type":"object","required":["@context","@type","@id","name","url","license","dataset"],"properties":{"@context":{"const":"https://schema.org"},"@type":{"const":"DataCatalog"},"@id":{"type":"string","format":"uri"},"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"license":{"type":"string","format":"uri"},"isAccessibleForFree":{"type":"boolean"},"dateModified":{"type":"string","format":"date"},"publisher":{"type":"object","additionalProperties":true},"creator":{"type":"object","additionalProperties":true},"dataset":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"PublicDataset":{"type":"object","required":["id","path","title","description","recordCount","dateModified","category","apiDocsPath","license","attribution"],"properties":{"id":{"type":"string"},"path":{"type":"string"},"title":{"type":"string"},"description":{"type":"string"},"recordCount":{"type":"integer","minimum":0},"dateModified":{"type":"string","format":"date"},"category":{"enum":["reference","figures"]},"humanPath":{"type":"string"},"apiDocsPath":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"primarySourceNote":{"type":"string"}}},"Source":{"type":"object","required":["label","url","lastVerified"],"properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"},"authority":{"type":"string"},"lastVerified":{"type":"string","format":"date"}}},"CitationPacksResponse":{"type":"object","required":["lastModified","count","datasetUrl","license","attribution","legalNote","packs"],"properties":{"lastModified":{"type":"string","format":"date"},"count":{"type":"integer","minimum":0},"datasetUrl":{"type":"string","format":"uri"},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"legalNote":{"type":"string"},"packs":{"type":"array","items":{"$ref":"#/components/schemas/CitationPack"}}}},"CitationPack":{"type":"object","required":["id","kind","title","summary","answer","url","canonicalPageUrl","datasetUrl","dateModified","facts","sources","sourceCount","suggestedCitation","license","attribution","legalNote"],"properties":{"id":{"type":"string"},"kind":{"enum":["cost-to-complete","calculator-verdict","express-entry","best-guide","visa-route","page-answer","fee","processing-time","salary-threshold","settlement","policy-claim","fact-change","research-report"]},"title":{"type":"string"},"summary":{"type":"string"},"answer":{"type":"string"},"url":{"type":"string","format":"uri"},"canonicalPageUrl":{"type":"string","format":"uri"},"datasetUrl":{"type":"string","format":"uri"},"dateModified":{"type":"string","format":"date"},"facts":{"type":"array","items":{"$ref":"#/components/schemas/CitationPackFact"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/CitationPackSource"}},"sourceCount":{"type":"integer","minimum":0},"suggestedCitation":{"type":"string"},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"legalNote":{"type":"string"}}},"CitationPackFact":{"type":"object","required":["label","value","sourceUrls"],"properties":{"label":{"type":"string"},"value":{"type":"string"},"note":{"type":"string"},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}}}},"CitationPackSource":{"type":"object","required":["label","url"],"properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"},"authority":{"type":"string"},"lastVerified":{"type":"string","format":"date"}}},"AnswerCapsulesResponse":{"type":"object","required":["version","name","description","datasetUrl","humanUrl","count","lastModified","license","attribution","legalNote","methodology","summary","capsules"],"properties":{"version":{"type":"string","format":"date"},"name":{"const":"Verified answer capsules"},"description":{"type":"string"},"datasetUrl":{"type":"string","format":"uri"},"humanUrl":{"type":"string","format":"uri"},"count":{"type":"integer","minimum":0},"lastModified":{"type":"string","format":"date"},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"legalNote":{"type":"string"},"methodology":{"type":"array","items":{"type":"string"}},"summary":{"type":"object","required":["kinds","sourceUrlCount","canonicalPageCount"],"properties":{"kinds":{"type":"array","items":{"type":"object","required":["kind","count"],"properties":{"kind":{"enum":["fee","processing-time","salary-threshold","cost-to-complete","calculator-verdict","express-entry","settlement","timeline","best-guide","topic-cluster","visa-route","page-answer","research-report"]},"count":{"type":"integer","minimum":0}}}},"sourceUrlCount":{"type":"integer","minimum":0},"canonicalPageCount":{"type":"integer","minimum":0}}},"capsules":{"type":"array","items":{"$ref":"#/components/schemas/AnswerCapsule"}}}},"AnswerCapsule":{"type":"object","required":["id","kind","question","answer","pagePath","url","canonicalPageUrl","datasetUrls","sourceUrls","sources","dateModified","renderedSelector","suggestedCitation","license","attribution","legalNote"],"properties":{"id":{"type":"string"},"kind":{"enum":["fee","processing-time","salary-threshold","cost-to-complete","calculator-verdict","express-entry","settlement","timeline","best-guide","topic-cluster","visa-route","page-answer","research-report"]},"question":{"type":"string"},"answer":{"type":"string"},"pagePath":{"type":"string"},"url":{"type":"string","format":"uri"},"canonicalPageUrl":{"type":"string","format":"uri"},"datasetUrls":{"type":"array","items":{"type":"string","format":"uri"}},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/AnswerCapsuleSource"}},"dateModified":{"type":"string","format":"date"},"renderedSelector":{"const":"[data-verified-answer]"},"suggestedCitation":{"type":"string"},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"legalNote":{"type":"string"}}},"AnswerCapsuleSource":{"type":"object","required":["label","url","lastVerified"],"properties":{"label":{"type":"string"},"url":{"type":"string","format":"uri"},"authority":{"type":"string"},"lastVerified":{"type":"string","format":"date"}}},"IndexablePageManifest":{"type":"object","required":["version","name","datasetUrl","sitemapUrl","license","attribution","count","summary","methodology","pages"],"properties":{"version":{"type":"string","format":"date"},"name":{"const":"Visa Atlas indexable page manifest"},"description":{"type":"string"},"datasetUrl":{"type":"string","format":"uri"},"sitemapUrl":{"type":"string","format":"uri"},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"lastModified":{"type":"string","format":"date"},"count":{"type":"integer","minimum":0},"summary":{"type":"object","required":["totalPages","pagesWithLastModified","highPriorityPages","cohorts"],"properties":{"totalPages":{"type":"integer","minimum":0},"pagesWithLastModified":{"type":"integer","minimum":0},"highPriorityPages":{"type":"integer","minimum":0},"cohorts":{"type":"array","items":{"type":"object","required":["cohort","count"],"properties":{"cohort":{"type":"string"},"count":{"type":"integer","minimum":0}}}}}},"methodology":{"type":"array","items":{"type":"string"}},"pages":{"type":"array","items":{"$ref":"#/components/schemas/IndexablePageManifestRow"}}}},"IndexablePageManifestRow":{"type":"object","required":["url","path","cohort","sourceDatasets"],"properties":{"url":{"type":"string","format":"uri"},"path":{"type":"string"},"cohort":{"type":"string"},"changeFrequency":{"type":"string"},"priority":{"type":"number"},"lastModified":{"type":"string","format":"date"},"sourceDatasets":{"type":"array","items":{"type":"string"}}}},"RouteFinderRequest":{"type":"object","additionalProperties":false,"properties":{"professionSlug":{"type":"string","minLength":1,"maxLength":80},"nationalityIso":{"type":"string","minLength":2,"maxLength":20},"targetDestinations":{"type":"array","maxItems":12,"items":{"type":"string","minLength":2,"maxLength":80}},"sponsorshipAvailable":{"enum":["yes","no","unsure"]},"needsSettlement":{"type":"boolean"},"hasHigherEducation":{"type":"boolean"},"hasLanguageB2":{"type":"boolean"},"capitalBand":{"enum":["none","under-50k","50k-250k","250k-plus"]},"ageBand":{"enum":["under-30","30-44","45-plus"]},"salaryBand":{"enum":["under-25k","25k-40k","40k-60k","60k-90k","90k-150k","150k-plus"]},"dependants":{"type":"integer","minimum":0,"maximum":10},"routeIntent":{"enum":["move","work","study","family","visit","business-trip","remote-work","invest","citizenship","protection"]},"limit":{"type":"integer","minimum":1,"maximum":12,"default":8}}},"RouteFinderResponse":{"type":"object","required":["version","name","legalNote","methodology","count","returned","results"],"properties":{"version":{"type":"string","format":"date"},"name":{"type":"string"},"description":{"type":"string"},"apiPath":{"const":"/api/public/route-finder"},"humanUrl":{"type":"string","format":"uri"},"method":{"const":"POST"},"license":{"const":"CC BY 4.0"},"attribution":{"const":"Visa Atlas"},"legalNote":{"type":"string"},"methodology":{"type":"array","items":{"type":"string"}},"sourceDatasets":{"type":"array","items":{"type":"string"}},"input":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}},"count":{"type":"integer","minimum":0},"returned":{"type":"integer","minimum":0},"dateModified":{"type":"string","format":"date"},"results":{"type":"array","items":{"$ref":"#/components/schemas/RouteFinderResult"}}}},"RouteFinderContract":{"allOf":[{"$ref":"#/components/schemas/RouteFinderResponse"},{"type":"object","properties":{"inputFields":{"type":"array","items":{"type":"object","additionalProperties":true}},"exampleRequest":{"$ref":"#/components/schemas/RouteFinderRequest"},"exampleResponse":{"$ref":"#/components/schemas/RouteFinderResponse"}}}]},"RouteFinderResult":{"type":"object","required":["rank","score","reasons","canonicalUrl","route","sources","sourceUrls"],"properties":{"rank":{"type":"integer","minimum":1},"score":{"type":"number","description":"Ordering score only; not an official eligibility score."},"reasons":{"type":"array","items":{"type":"string"}},"pagePath":{"type":"string"},"canonicalUrl":{"type":"string","format":"uri"},"route":{"type":"object","required":["destinationIso","destinationSlug","destinationName","visaSlug","visaName","lastReviewed"],"properties":{"destinationIso":{"type":"string"},"destinationSlug":{"type":"string"},"destinationName":{"type":"string"},"visaSlug":{"type":"string"},"visaName":{"type":"string"},"category":{"type":"string"},"sponsorshipRequired":{"type":"boolean"},"leadsToSettlement":{"type":"boolean"},"summary":{"type":"string"},"lastReviewed":{"type":"string","format":"date"}}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"sourceUrls":{"type":"array","items":{"type":"string","format":"uri"}}}},"ErrorResponse":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"},"issues":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}},"x-attribution":"Visa Atlas","x-license":"https://creativecommons.org/licenses/by/4.0/","x-primary-source-policy":"Keep the Visa Atlas canonical URL, official government source URL and review date attached to copied factual figures.","x-legal-note":"Visa Atlas publishes compiled immigration information and route matching for planning. It is not legal advice and not an issuing authority.","x-release-gate":"npm run audit:seo-geo"}