{"uid":"cap_MMFauznnEmE6uKwBS0Zd2","slug":"immigrationpulse-citizenship-intelligence-api-dde97373","name":"ImmigrationPulse Citizenship Intelligence API","description":"Citizenship by investment (CBI) / second passport finder. Covers citizenship-by-investment programs, ancestry and heritage citizenship routes, naturalization timelines, and second-passport strategies worldwide. For immigration and relocation agents.","url":"https://immigrationpulse.vercel.app/api/citizenship","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"type":"string","description":"lang"},"type":{"type":"string","description":"type (default: investment)"},"budget":{"type":"string","description":"Budget in USD for investment citizenship (e.g. 150000, 500000, 1000000)"},"ancestry":{"type":"string","description":"Country for ancestry citizenship check (e.g. Italy, Ireland, Germany)"},"nationality":{"type":"string","description":"nationality"}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.15","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":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.15/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_skmBQjIxw0Cyq-JvOR1Ze","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns global citizenship acquisition intelligence covering citizenship by investment (CBI), ancestry/heritage routes, naturalization timelines, and second-passport strategies for a given country or scenario.","exampleAgentPrompt":"What are the citizenship by investment options available in Portugal — including the minimum investment required, how long the process takes, and whether it leads to an EU passport?","exampleUseCases":[{"title":"Ancestry citizenship pathway finder","prompt":"I have a Lithuanian grandmother — can I claim citizenship through her, and what documents would I need to prove the connection? Also, how long would the process typically take?"},{"title":"Budget second passport comparison tool","prompt":"I'm looking for the most affordable citizenship by investment program in the Caribbean that I can complete within 18 months. Can you compare the costs and timelines for me?"},{"title":"Fast naturalization route planner","prompt":"I'm already living in Spain on a residency visa — what's the timeline to become a Spanish citizen through naturalization, and are there any ways to speed up the process?"}],"resultDescription":"Returns structured citizenship intelligence for the queried country or route, including available citizenship acquisition pathways (CBI, ancestry, naturalization), investment thresholds, residency requirements, processing timelines, eligibility criteria, and second-passport strategic notes.","failureModes":["Country not covered by the dataset — returns empty or limited results","Invalid or unrecognized country name — may return error or no match","Ancestry route not available for requested nationality — pathway marked unavailable","CBI program suspended or changed — data may be stale if not recently refreshed","Missing required query parameters — returns 400 or validation error"],"whenToPreferThis":"Use this endpoint when an agent needs detailed, structured citizenship acquisition intelligence — especially for CBI programs, ancestry routes, or naturalization — rather than general visa or residency data. Prefer this over the PR or visa endpoints when the user's goal is acquiring full citizenship or a second passport, not just residency or travel access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:46:28.141Z","isFirstParty":false}