Input schema (JSON)
{
"type": "object",
"required": [
"home_country"
],
"properties": {
"sea": {
"enum": [
"coast",
"near",
"any"
],
"type": "string",
"description": "coast = only countries with a coastline; near = sea is a plus; any = does not matter."
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "How many countries to return (default 5)."
},
"climate": {
"type": "array",
"items": {
"enum": [
"warm",
"mild",
"cold"
],
"type": "string"
},
"description": "Wanted climates (any of them). warm = average 17 C or more, mild = 9 to 24 C, cold = 15 C or less. Empty = climate does not matter."
},
"age_band": {
"enum": [
"u30",
"30-45",
"45-60",
"60+"
],
"type": "string"
},
"household": {
"enum": [
"solo",
"couple",
"kids"
],
"type": "string",
"description": "Who is moving: alone, with a partner, or with children."
},
"priorities": {
"type": "array",
"items": {
"enum": [
"tax",
"cost",
"safety",
"near",
"lang",
"life"
],
"type": "string"
},
"description": "Ordered list, most important first. Values: tax (low taxes), cost (low cost of living), safety, near (close to home and family), lang (they speak my language), life (healthcare and long life expectancy)."
},
"home_country": {
"type": "string",
"description": "Country the user is from (English name or ISO code). Distance to family and language are measured from here. Required."
},
"current_country": {
"type": "string",
"description": "Country the user lives in now, if different. Cost and current tax are compared with this one, and it is left out of the results."
},
"min_internet_mbps": {
"type": "number",
"description": "Minimum fixed broadband speed in Mbps (approximate national median)."
},
"monthly_income_eur": {
"type": "number",
"description": "Monthly income in euros before tax. Used to estimate the income tax the user would pay in each country."
},
"max_hours_difference": {
"type": "number",
"description": "Maximum hours of difference from work_timezone_utc_offset (default 3 when an offset is given)."
},
"residency_budget_eur": {
"type": "number",
"description": "Money available for a residency deposit or investment. Hides countries whose minimum is higher."
},
"needs_digital_nomad_visa": {
"type": "boolean",
"description": "Only countries with a digital nomad or remote-work visa in our data (and, if income is given, whose income requirement the user meets)."
},
"work_timezone_utc_offset": {
"type": "number",
"description": "UTC offset of the team or clients the user works with, for example -5 for New York in winter or 1 for Berlin."
}
}
}