{"version":"2026-07-03","name":"Visa Atlas route finder API","description":"Deterministic profile-to-route matching over indexable Visa Atlas visa routes, returning ranked route candidates with canonical pages, source URLs and review dates.","path":"/api/public/route-finder","humanUrl":"https://visaatlas.org/triage","method":"POST","license":"CC BY 4.0","attribution":"Visa Atlas","legalNote":"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.","methodology":["Runs deterministic scoring over the indexable Visa Atlas visa registry; no LLM is called at runtime.","Scores are planning hints based on route category, sponsorship, settlement, profession tags, nationality gates, age, salary band and declared intent.","Returned route facts carry canonical Visa Atlas pages, official source URLs and review dates; the issuing authority remains the source of truth.","Routes outside the public index are excluded so the API mirrors the site crawl policy."],"sourceDatasets":["/api/public/visas","/api/public/destinations","/api/public/salary-thresholds","/api/public/processing-times","/api/public/cost-to-complete"],"inputFields":[{"name":"professionSlug","type":"string?","description":"Optional profession slug from the Visa Atlas profession taxonomy; unknown values are ignored with a warning."},{"name":"nationalityIso","type":"string?","description":"Optional nationality ISO from the Visa Atlas nationality table; used for bilateral or nationality-gated route checks."},{"name":"targetDestinations","type":"string[]?","description":"Optional ISO codes or slugs for public indexable destinations; non-indexable destinations are ignored with a warning."},{"name":"sponsorshipAvailable","type":"yes | no | unsure","description":"Whether the user has employer or sponsor backing."},{"name":"needsSettlement","type":"boolean?","description":"Whether settlement or permanent residence matters to the user."},{"name":"hasHigherEducation","type":"boolean?","description":"Whether the user has higher-education evidence."},{"name":"hasLanguageB2","type":"boolean?","description":"Whether the user has B2-level destination-language evidence."},{"name":"capitalBand","type":"none | under-50k | 50k-250k | 250k-plus","description":"Indicative capital band for investor or entrepreneur routes."},{"name":"ageBand","type":"under-30 | 30-44 | 45-plus","description":"Broad age band used for youth-mobility and points-route scoring."},{"name":"salaryBand","type":"under-25k | 25k-40k | 40k-60k | 60k-90k | 90k-150k | 150k-plus","description":"Broad annual salary band used only as a coarse planning signal."},{"name":"dependants","type":"integer 0-10?","description":"Number of dependants migrating with the principal applicant."},{"name":"routeIntent","type":"move | work | study | family | visit | business-trip | remote-work | invest | citizenship | protection","description":"Primary user intent; defaults to move."},{"name":"limit","type":"integer 1-12?","description":"Maximum ranked routes to return; defaults to 8."}],"exampleRequest":{"professionSlug":"software-engineer","nationalityIso":"in","targetDestinations":["uk","germany","canada"],"sponsorshipAvailable":"yes","needsSettlement":true,"hasHigherEducation":true,"hasLanguageB2":true,"ageBand":"30-44","salaryBand":"60k-90k","dependants":1,"routeIntent":"work","limit":3},"exampleResponse":{"version":"2026-07-03","name":"Visa Atlas route finder","description":"Deterministic profile-to-route matching over indexable Visa Atlas visa routes, returning ranked route candidates with canonical pages, source URLs and review dates.","apiPath":"/api/public/route-finder","humanUrl":"https://visaatlas.org/triage","method":"POST","license":"CC BY 4.0","attribution":"Visa Atlas","legalNote":"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.","methodology":["Runs deterministic scoring over the indexable Visa Atlas visa registry; no LLM is called at runtime.","Scores are planning hints based on route category, sponsorship, settlement, profession tags, nationality gates, age, salary band and declared intent.","Returned route facts carry canonical Visa Atlas pages, official source URLs and review dates; the issuing authority remains the source of truth.","Routes outside the public index are excluded so the API mirrors the site crawl policy."],"sourceDatasets":["/api/public/visas","/api/public/destinations","/api/public/salary-thresholds","/api/public/processing-times","/api/public/cost-to-complete"],"input":{"limit":3,"professionSlug":"software-engineer","nationalityIso":"in","targetDestinations":[{"iso":"uk","slug":"uk","name":"United Kingdom of Great Britain and Northern Ireland"},{"iso":"de","slug":"germany","name":"Federal Republic of Germany"},{"iso":"ca","slug":"canada","name":"Canada"}],"sponsorshipAvailable":"yes","needsSettlement":true,"hasHigherEducation":true,"hasLanguageB2":true,"ageBand":"30-44","salaryBand":"60k-90k","dependants":1,"routeIntent":"work"},"warnings":[],"count":3,"returned":3,"dateModified":"2026-06-22","results":[{"rank":1,"score":88,"reasons":["Matches your selected route intent.","Matches your profession tags (2).","You have sponsorship, and this route uses it.","Leads to permanent residence.","Higher education aligns with skilled-route eligibility.","Destination language skills give you an advantage.","Your salary band clears the typical threshold.","Settlement-leading route suits migrating with family.","For Indian applicants: Indian nationals are the largest EU Blue Card cohort in Germany."],"pagePath":"/visas/germany/eu-blue-card","canonicalUrl":"https://visaatlas.org/visas/germany/eu-blue-card","route":{"destinationIso":"de","destinationSlug":"germany","destinationName":"Federal Republic of Germany","visaSlug":"eu-blue-card","visaName":"EU Blue Card (Germany)","category":"work-sponsored","sponsorshipRequired":true,"leadsToSettlement":true,"summary":"Work and residence permit for highly qualified non-EU professionals with a qualifying German job offer.","lastReviewed":"2026-06-22"},"sources":[{"label":"Make it in Germany — EU Blue Card","url":"https://www.make-it-in-germany.com/en/visa-residence/types/eu-blue-card","authority":"BMWK / Federal Government","lastVerified":"2026-06-22"},{"label":"Federal Foreign Office — EU Blue Card FAQ","url":"https://www.auswaertiges-amt.de/en/visa-service/buergerservice/faq/02a-what-is-the-blue-card/606754","authority":"German Federal Foreign Office","lastVerified":"2026-06-22"}],"sourceUrls":["https://www.make-it-in-germany.com/en/visa-residence/types/eu-blue-card","https://www.auswaertiges-amt.de/en/visa-service/buergerservice/faq/02a-what-is-the-blue-card/606754"]},{"rank":2,"score":70,"reasons":["Matches your selected route intent.","Matches your profession tags (1).","You have sponsorship, and this route uses it.","Leads to permanent residence.","Higher education aligns with skilled-route eligibility.","Your salary band clears the typical threshold.","Settlement-leading route suits migrating with family.","For Indian applicants: Indian nationals are the largest Skilled Worker cohort."],"pagePath":"/visas/uk/skilled-worker","canonicalUrl":"https://visaatlas.org/visas/uk/skilled-worker","route":{"destinationIso":"uk","destinationSlug":"uk","destinationName":"United Kingdom of Great Britain and Northern Ireland","visaSlug":"skilled-worker","visaName":"Skilled Worker visa","category":"work-sponsored","sponsorshipRequired":true,"leadsToSettlement":true,"summary":"Work visa for non-UK workers with a job offer from a Home Office–licensed sponsor in an eligible occupation.","lastReviewed":"2026-06-01"},"sources":[{"label":"GOV.UK — Skilled Worker visa","url":"https://www.gov.uk/skilled-worker-visa","authority":"UK Home Office","lastVerified":"2026-06-01"},{"label":"Immigration Rules Appendix Skilled Worker","url":"https://www.gov.uk/guidance/immigration-rules/immigration-rules-appendix-skilled-worker","authority":"UK Home Office","lastVerified":"2026-06-01"},{"label":"Immigration Salary List","url":"https://www.gov.uk/government/publications/skilled-worker-visa-immigration-salary-list","authority":"UK Home Office","lastVerified":"2026-06-01"}],"sourceUrls":["https://www.gov.uk/skilled-worker-visa","https://www.gov.uk/guidance/immigration-rules/immigration-rules-appendix-skilled-worker","https://www.gov.uk/government/publications/skilled-worker-visa-immigration-salary-list"]},{"rank":3,"score":63,"reasons":["Matches your selected route intent.","Matches your profession tags (1).","You have sponsorship, and this route uses it.","Leads to permanent residence.","Higher education aligns with skilled-route eligibility.","Destination language skills give you an advantage.","Settlement-leading route suits migrating with family.","For Indian applicants: Indian nationals are one of the largest Skilled Worker cohorts in Germany, concentrated in IT and engineering."],"pagePath":"/visas/germany/skilled-worker-de","canonicalUrl":"https://visaatlas.org/visas/germany/skilled-worker-de","route":{"destinationIso":"de","destinationSlug":"germany","destinationName":"Federal Republic of Germany","visaSlug":"skilled-worker-de","visaName":"Skilled Worker residence permit (§18a/§18b AufenthG)","category":"work-sponsored","sponsorshipRequired":true,"leadsToSettlement":true,"summary":"Sponsored work and residence permit for qualified non-EU workers from any country worldwide who have a German job offer and a recognised qualification.","lastReviewed":"2026-06-22"},"sources":[{"label":"Make it in Germany — Work visa for qualified professionals","url":"https://www.make-it-in-germany.com/en/visa-residence/types/work-qualified-professionals","authority":"BMWK / Federal Government","lastVerified":"2026-06-22"}],"sourceUrls":["https://www.make-it-in-germany.com/en/visa-residence/types/work-qualified-professionals"]}]}}