# ImmigrationPulse Permanent Residency Pathway Ranker

> ImmigrationPulse Permanent Residency Pathway Ranker is a paid API for AI agents from immigrationpulse.vercel.app, paid per call via x402, $0.2/call, status unknown (last checked 2026-09-15).

Ranks every permanent residency pathway for a given nationality and destination country, with timelines, costs, and onward citizenship routes

## Facts

- Endpoint: GET https://immigrationpulse.vercel.app/api/pathway
- Price: $0.2/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/immigrationpulse-permanent-residency-pathway-ranker-41fdcdc0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fW_3dd5-bGdYUJ8u7IPHu

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-permanent-residency-pathway-ranker-41fdcdc0
```

Example prompt: Can you rank all the permanent residency pathways available for an Indian national wanting to move to Canada, including timelines, costs, and which route eventually leads to citizenship?

## When to prefer this

Use this endpoint when you need a comprehensive, ranked overview of all PR pathways for a specific nationality-destination pair — especially when comparing multiple routes, understanding costs and timelines holistically, or mapping the full journey to eventual citizenship. Prefer this over point-estimator or single-visa endpoints when the user wants strategic route planning rather than eligibility scoring for one specific program.

## Known failure modes

- Unsupported nationality or destination country returns empty results or error
- No PR pathways exist for the given combination
- Stale or outdated policy data if immigration rules have recently changed
- Missing required query parameters returns a 400-level error

## How this service works

Permanent residency pathway finder / green card roadmap for any nationality and destination worldwide. Ranks every PR route by eligibility, timeline, cost, and difficulty, with the onward citizenship path. For immigration and relocation agents.

## Output

A ranked list of all available permanent residency pathways for the specified nationality/destination pair, each with estimated processing timelines, total cost breakdowns, eligibility criteria, and the onward route to citizenship

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "lang": {
   "type": "string",
   "description": "lang"
  },
  "education": {
   "type": "string",
   "description": "Highest education level (e.g. bachelor, master, PhD)"
  },
  "occupation": {
   "type": "string",
   "description": "Job title or NOC/SOC code — improves pathway matching"
  },
  "destination": {
   "type": "string",
   "description": "destination (default: Canada)"
  },
  "nationality": {
   "type": "string",
   "description": "nationality (default: Filipino)"
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/immigrationpulse-permanent-residency-pathway-ranker-41fdcdc0/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)