# ImmigrationPulse Citizenship Intelligence API

> ImmigrationPulse Citizenship Intelligence API is a paid API for AI agents from immigrationpulse.vercel.app, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-15).

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.

## Facts

- Endpoint: GET https://immigrationpulse.vercel.app/api/citizenship
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/immigrationpulse-citizenship-intelligence-api-dde97373
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MMFauznnEmE6uKwBS0Zd2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability immigrationpulse-citizenship-intelligence-api-dde97373
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {}
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/immigrationpulse-citizenship-intelligence-api-dde97373/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from immigrationpulse.vercel.app](https://www.zero.xyz/host/immigrationpulse.vercel.app/llms.txt)