What it costs to arrive in a country

The cash needed to ARRIVE, as distinct from what a month costs once you live there: the entry fee for a given passport, the first month's rent, the deposit, and a long-stay visa fee where one has been verified against the issuing government. READ complete BEFORE totalUsd. Rent covers a subset of the country spine and most visa fees could not be verified, so the total is a FLOOR whenever complete is false, and missing names each component that could not be priced. The total can legitimately be 0 - visa-free entry into a country with no rent figure sums to nothing known - which is honest arithmetic and a false headline. depositMonths is a stated assumption rather than a measurement: no free global dataset of deposit norms exists. The entry ROUTE is derived exactly from passport mobility data, so 'visa-free for this passport' is always answered even where no fee is. The destination must be in the PPP registry; some countries with a verified nomad-visa fee are reachable only through /api/visas.json.

get/api/arrival.json

Request

  • Base URL: https://geo-parity.com
  • URL: https://geo-parity.com/api/arrival.json
  • Auth: one of:
    • none
    • HTTP bearer
    • API key in query parameter key

Query parameters

passportstring required

ISO 3166-1 alpha-2 of the traveller's passport. Determines the entry route and therefore the fee.

destinationstring required

ISO 3166-1 alpha-2 of the destination. Must be in the PPP country registry.

depositMonthsnumber

Months of rent held as a deposit. Defaults to the site's stated assumption of 1.

incomenumber

Monthly remote income in USD. Optional; enables housing's income-relative view.

Response

Ranked countries with rentBasis, per-metric reference years, a count of countries excluded for want of the sorted metric, and an attribution block.

Changes

No recorded changes to this operation across all 1 revision of this API.