{"uid":"cap_9s-ixWCcNw0AzlyS9Z_gr","slug":"immigration-pulse-retirement-visa-finder-f78acbcb","name":"Immigration Pulse Retirement Visa Finder","description":"Retirement visa finder / retire-abroad country ranker. Ranks the best retirement and pensionado visa countries worldwide by income requirements, healthcare, taxes, cost of living, and path to permanent residency. For retirement and relocation agents.","url":"https://immigrationpulse.theaslangroupllc.com/api/retirement?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"lang":{"type":"string","description":"lang"},"budget":{"type":"string","description":"Monthly income/pension budget in USD (default: 2500)"},"priority":{"type":"string","description":"priority"},"nationality":{"type":"string","description":"nationality (default: American)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","errors":{"400":{"example":{"error":"invalid request"},"description":"Invalid or missing parameter(s). Returned before the payment gate on paid requests, so a malformed call is never charged. JSON body: { error: <what is wrong and how to fix it> } plus usage hints."},"402":{"description":"Payment required — x402 v2 challenge; the accepts array lists scheme, network, and amount. Retry the same request with a PAYMENT-SIGNATURE (v2) or X-PAYMENT (v1) header. Verification is free."},"500":{"example":{"error":"upstream_failed"},"description":"Unexpected server error. If a payment settled without a usable result, contact info@theaslangroupllc.com with the settlement tx hash for a re-run or credit."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"10.0000","medianCents":"10.0000","p90Cents":"10.0000","minCents":"10.0000","maxCents":"10.0000","p95Cents":"10.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lqQNGJ07TGvgYO2AnXmED","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Ranks the best retirement and pensionado visa countries worldwide by income requirements, healthcare, taxes, cost of living, and path to permanent residency","exampleAgentPrompt":"I'm looking to retire abroad on about $2,500 a month — can you rank the best countries for a retirement or pensionado visa, factoring in healthcare quality, low taxes, affordable cost of living, and ideally a path to permanent residency?","exampleUseCases":null,"resultDescription":"Returns a ranked list of countries offering retirement or pensionado visas, each scored and described by minimum income requirements, healthcare system quality, tax treatment of foreign pension income, cost of living index, and available path to permanent residency — helping retirees quickly compare and shortlist destinations.","failureModes":["Missing or invalid income parameter returns an error or unfiltered results","Obscure regional preferences may return no matching results","Data may lag behind recent visa policy changes in fast-moving jurisdictions","Overly restrictive filter combinations may yield an empty ranked list"],"whenToPreferThis":"Use this endpoint when a user wants to find and compare retirement or pensionado visa options across multiple countries simultaneously, ranked by practical criteria like income thresholds, healthcare, taxes, and cost of living. Prefer this over a generic immigration comparison tool when the user specifically needs retirement-focused visa programs (not digital nomad or work visas).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T18:43:55.181Z","isFirstParty":false,"canonicalSlug":"immigration-pulse-retirement-visa-finder-f78acbcb"}