# Can I enter? — visa & entry requirements API

Answers "does a holder of passport X need a visa for country Y?" with structured JSON.
Requirement values: visa_free (with allowed_stay_days), visa_on_arrival, e_visa, eta,
visa_required, no_admission.

Data source: Passport Index (passportindex.org) via imorte/passport-index-data (retrieved 2026-08-07).

Responses also include an "entry_rules" block per destination: passport validity minimums,
blank pages, onward-ticket rules, yellow-fever certificate requirements (with
applies_to_this_passport), other health requirements, transit-without-visa (TWOV) programs,
and residence-permit exemptions — each field individually source-cited, with last_verified,
staleness_days, and a coverage flag ("extended" = curated and verified; "basic" = not yet
curated, fields null). Transit lookups include the transit country's TWOV programs.
Scope caveats: work/study visas and immigration are not covered; assume ordinary passport,
tourism, single nationality. Always relay the included disclaimer to end users.

## Free tier (no payment, 5 requests/day per IP — for humans and light testing)

GET https://canienter.com/free/check?passport=NLD&destination=JPN
GET https://canienter.com/free/check?passport=NLD&destination=JPN&transit=DOH

## Paid tier (x402 protocol — pay per request in USDC, no account or API key)

GET https://canienter.com/v1/check?passport=NLD&destination=JPN     — $0.01
GET https://canienter.com/v1/passport/NLD                           — $0.05 (all 198 destinations)

An unpaid request returns HTTP 402 with machine-readable payment instructions.
Use any x402-capable client to pay and retry automatically, e.g.:

- JavaScript: @x402/fetch (wraps fetch; sign with a viem/ethers wallet)
- Claude/agents: Coinbase's "x402" Agent Skill, or the CanIEnter "visa-check" skill
- Network: eip155:8453 (Base mainnet, USDC) — live

## Machine-readable spec

OpenAPI: https://canienter.com/openapi.json