{
  "schema_version": "1.0",
  "name": "ImmigrationPulse",
  "description": "Global immigration intelligence API serving 281M+ migrants and 35M+ digital nomads. 11 endpoints: points calculators (Express Entry CRS, SkillSelect, UK PBS, Germany), visa requirements for any nationality/destination pair, PR pathways (Green Card, Express Entry, EU Blue Card), digital nomad visa finder (50+ countries), citizenship by investment and ancestry programs, USCIS case status + Visa Bulletin decoding, global retirement visa intelligence, immigrant rights, and complete cost breakdowns. Includes Boundless + CitizenPath filing service links, Wise + Remitly money transfer links. x402 micropayment \u2014 USDC on Base.",
  "url": "https://immigrationpulse.vercel.app",
  "payment": {
    "protocol": "x402",
    "network": "base-mainnet",
    "currency": "USDC",
    "pricing_model": "per_request"
  },
  "global_coverage": [
    "United States (all visa categories, USCIS, Visa Bulletin)",
    "Canada (Express Entry, PNP, spousal, study)",
    "United Kingdom (Skilled Worker, Student, Spouse, ILR)",
    "Australia (points-tested, employer-sponsored, partner)",
    "Germany (Blue Card, skilled immigration, family)",
    "Portugal (D7, D8 nomad, Golden Visa)",
    "Singapore (Employment Pass, PR)",
    "Japan (Highly Skilled Professional, Work, Student)",
    "UAE (Work, Investor, Remote Work, Golden Visa)",
    "New Zealand (Skilled Migrant, partner, student)",
    "Ireland (Critical Skills, Stamp 4)",
    "Netherlands (Highly Skilled Migrant, Orientation Year)",
    "Caribbean CBI programs (St. Kitts, Dominica, Grenada, Antigua, St. Lucia)",
    "EU (Schengen visa, Blue Card, nomad visas across 27 member states)",
    "Latin America (Mexico, Costa Rica, Panama, Colombia, Ecuador)",
    "Southeast Asia (Thailand, Malaysia, Indonesia, Vietnam, Philippines)",
    "MENA (Bahrain, Saudi, Jordan)",
    "Africa (South Africa, Mauritius, Kenya)",
    "Others via Tavily real-time synthesis"
  ],
  "languages": [
    "en",
    "hi",
    "tl",
    "es",
    "ar",
    "zh",
    "pt",
    "fr",
    "de",
    "ja",
    "ko",
    "bn",
    "ur",
    "sw",
    "vi",
    "id",
    "tr",
    "ro"
  ],
  "endpoints": [
    {
      "path": "/api/points",
      "method": "GET",
      "description": "Skilled-worker points estimator \u2014 Canada Express Entry CRS score, Australia SkillSelect points, UK PBS eligibility, Germany Chancenkarte, Austria Red-White-Red Card; includes gap analysis and ranked improvement roadmap",
      "parameters": {
        "system": "string (express-entry | skillselect | uk-pbs | germany | nz | austria | any)",
        "age": "string (applicant age, e.g. '31')",
        "education": "string (phd | masters | bachelors | diploma | trade)",
        "clb": "string (Canadian Language Benchmark, e.g. '9')",
        "ielts": "string (IELTS band score, e.g. '7.5')",
        "work_years": "string (years of foreign skilled work experience)",
        "local_work": "string (years of work inside destination country)",
        "job_offer": "boolean (true/false)",
        "nomination": "boolean (provincial/state nomination, true/false)",
        "partner": "boolean (qualifying partner, true/false)",
        "occupation": "string (job title or NOC/ANZSCO code, optional)",
        "lang": "string (BCP-47, optional)"
      },
      "price_usd": 0.1,
      "example": "/api/points?system=express-entry&age=31&education=masters&clb=9&work_years=5"
    },
    {
      "path": "/api/visa",
      "method": "GET",
      "description": "Visa requirements for any nationality/destination pair \u2014 all categories, work rights, processing times, fees, refusal risks",
      "parameters": {
        "nationality": "string",
        "destination": "string",
        "category": "string (optional: work/tourist/study/family/investor/all)",
        "lang": "string (optional, BCP-47)"
      },
      "price_usd": 0.15,
      "example": "/api/visa?nationality=Indian&destination=Canada&category=work"
    },
    {
      "path": "/api/pathway",
      "method": "GET",
      "description": "Complete roadmap to permanent residency \u2014 every pathway ranked by timeline, cost, and eligibility",
      "parameters": {
        "nationality": "string",
        "destination": "string",
        "occupation": "string (optional)",
        "education": "string (optional)",
        "lang": "string (optional)"
      },
      "price_usd": 0.2,
      "example": "/api/pathway?nationality=Filipino&destination=Canada"
    },
    {
      "path": "/api/nomad",
      "method": "GET",
      "description": "Digital nomad visa finder \u2014 50+ countries ranked by income threshold, tax treatment, lifestyle, and processing speed",
      "parameters": {
        "income": "string (monthly USD)",
        "nationality": "string",
        "preference": "string (optional: tax_free/low_cost/europe/asia/fastest)",
        "region": "string (optional)",
        "lang": "string (optional)"
      },
      "price_usd": 0.15,
      "example": "/api/nomad?income=3500&nationality=American&region=europe"
    },
    {
      "path": "/api/citizenship",
      "method": "GET",
      "description": "Citizenship intelligence \u2014 by investment (CBI), ancestry/heritage, naturalization timelines, second passport strategies",
      "parameters": {
        "type": "string (investment/ancestry/naturalization/second)",
        "budget": "string (optional, USD for CBI)",
        "ancestry": "string (optional, country)",
        "nationality": "string (optional)",
        "lang": "string (optional)"
      },
      "price_usd": 0.15,
      "example": "/api/citizenship?type=ancestry&ancestry=Italy"
    },
    {
      "path": "/api/status",
      "method": "GET",
      "description": "USCIS case status decoder \u2014 what your status means, what happens next, processing time context, escalation options",
      "parameters": {
        "receipt": "string (optional, USCIS receipt number)",
        "form": "string (optional, e.g. I-485)",
        "status": "string (optional, status text)",
        "lang": "string (optional)"
      },
      "price_usd": 0.1,
      "example": "/api/status?receipt=MSC2190012345&form=I-485"
    },
    {
      "path": "/api/bulletin",
      "method": "GET",
      "description": "US Visa Bulletin decoder \u2014 current priority dates, filing chart guidance, wait time estimates, movement trends",
      "parameters": {
        "category": "string (EB-1/EB-2/EB-3/F-1/F-2A/F-2B/F-3/F-4)",
        "chargeability": "string (country of chargeability)",
        "priority_date": "string (optional, YYYY-MM-DD)",
        "lang": "string (optional)"
      },
      "price_usd": 0.1,
      "example": "/api/bulletin?category=EB-2&chargeability=India"
    },
    {
      "path": "/api/retirement",
      "method": "GET",
      "description": "Global retirement visa intelligence \u2014 best countries ranked by income requirements, healthcare, tax treatment, cost of living",
      "parameters": {
        "nationality": "string",
        "budget": "string (monthly USD)",
        "priority": "string (optional: healthcare/tax_free/english/eu_access/cheapest)",
        "lang": "string (optional)"
      },
      "price_usd": 0.1,
      "example": "/api/retirement?nationality=American&budget=2500"
    },
    {
      "path": "/api/compare",
      "method": "GET",
      "description": "Side-by-side immigration comparison for any nationality across multiple destination countries",
      "parameters": {
        "nationality": "string",
        "destinations": "string (comma-separated countries)",
        "occupation": "string (optional)",
        "lang": "string (optional)"
      },
      "price_usd": 0.15,
      "example": "/api/compare?nationality=Nigerian&destinations=UK,Canada,Germany"
    },
    {
      "path": "/api/rights",
      "method": "GET",
      "description": "Immigrant rights by country and visa type \u2014 work authorization, healthcare, education, legal protections, deportation defense",
      "parameters": {
        "destination": "string",
        "visa_status": "string",
        "lang": "string (optional)"
      },
      "price_usd": 0.1,
      "example": "/api/rights?destination=US&visa_status=H-1B"
    },
    {
      "path": "/api/cost",
      "method": "GET",
      "description": "Complete immigration cost breakdown \u2014 government fees, attorney fees, medical, documents, DIY vs. attorney comparison, fee waivers",
      "parameters": {
        "visa_type": "string",
        "destination": "string",
        "with_attorney": "boolean (optional)",
        "family_size": "integer (optional)",
        "lang": "string (optional)"
      },
      "price_usd": 0.1,
      "example": "/api/cost?visa_type=I-485&destination=US&family_size=3"
    }
  ],
  "use_cases": [
    "Determining which visa a person needs before traveling or relocating",
    "Mapping the fastest or cheapest path to permanent residency for any nationality",
    "Finding the best digital nomad visa for a remote worker's income and preferences",
    "Planning citizenship by investment or researching ancestry citizenship eligibility",
    "Decoding confusing USCIS case statuses and understanding next steps",
    "Interpreting Visa Bulletin priority dates and wait times",
    "Comparing retirement destinations for expats",
    "Understanding immigrant rights before arrival in a new country",
    "Budgeting the total cost of an immigration process"
  ],
  "payment_instructions": "Include PAYMENT-SIGNATURE header with x402 payment. Receive 402 with payment requirements on first request.",
  "contact": "https://immigrationpulse.vercel.app"
}