Global Digital Nomad Visa Intelligence API

API ID 13039

Structured data for 35 digital nomad and remote-work visa programs worldwide. Endpoints cover listing and filtering programs, eligibility matching by nationality and income, scored recommendations, residency pathways, tax detail and estimates, comparison, dataset statistics, and a changelog. All data is curated from government immigration sources and updated quarterly. No database, no runtime scraping — fast and deterministic responses.

123 ms avg response

API Documentation

Endpoints

Request

Returns every digital nomad / remote-work visa program, with optional filters and sorting. Programs flagged `partial: true` are always included (their data may be incomplete). Results are sorted ascending by required USD income when `sort=income`; programs with no income requirement (`basis: "none"`) sort first.

Endpoint ID: 26224
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26224/list+visa+programs
INPUT PARAMETERS

List Visa Programs — Endpoint Features

Object Description
region Optional Optional. Filter by region: europe, asia, americas, africa, caribbean, oceania.
taxRegime Optional Optional. Filter by tax regime: exempt, flat, territorial, standard.
dependants Optional Optional. true to return only programs that allow dependants.
maxIncome Optional Optional. Return programs whose monthly USD-equivalent income threshold is at or below this value.
minStay Optional Optional. Return programs whose stay duration (months) is at or above this value.
pathToPR Optional Optional. true to return only programs offering a path to permanent residency.
pathToCitizenship Optional Optional. true to return only programs offering a path to citizenship.
maxProcessingDays Optional Optional. Return programs whose maximum processing time is at or below this many days.
visaFree Optional Optional. true to return only programs that require no formal application (e.g. Georgia).
maxCostOfLiving Optional Optional. Return programs at or below this cost-of-living band: budget, moderate, high, premium.
sort Optional Optional. Sort order: income, stay, processing, or citizenship (all ascending).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

region
taxRegime
dependants
maxIncome
minStay
pathToPR
pathToCitizenship
maxProcessingDays
visaFree
maxCostOfLiving
sort
API EXAMPLE RESPONSE
JSON
{"success":true,"data":[{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3480,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"4x Portuguese minimum wage"},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"NHR scheme abolished January 2024. Standard Portuguese progressive tax rates apply.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"25% per dependant","dependantUpliftPercent":25},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":20,"max":60},"onlineAvailable":true,"fee":{"amount":90,"currency":"EUR"}}},{"countryCode":"ES","countryName":"Spain","visaName":"Digital Nomad Visa (DNV)","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":2762,"currency":"EUR","period":"monthly","usdEquivalent":3000,"basis":"income","notes":"200% of Spanish minimum wage. Beckham Law flat-rate tax opt-in available for up to 6 years."},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10},"taxRegime":{"type":"flat","rate":0.24,"foreignIncomeExempt":false,"requires183Day":false,"notes":"Beckham Law: 24% flat rate on income up to €600,000 for up to 6 years. Opt-in required within 6 months of first Spanish tax return.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"75% per dependant","dependantUpliftPercent":75},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":70,"currency":"EUR"}}},{"countryCode":"HR","countryName":"Croatia","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":2540,"currency":"EUR","period":"monthly","usdEquivalent":2700,"basis":"income","notes":"Lowest income threshold among EU digital nomad visa programmes."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% income tax on foreign-sourced income for digital nomad visa holders.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":30,"currency":"EUR"}}},{"countryCode":"GR","countryName":"Greece","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3500,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"Applicants committing to 2-year tax residency receive a 50% income tax reduction for the first 7 years."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":7},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Greek progressive tax rates apply. A 50% income tax reduction is available for the first 7 years for those committing to 2-year tax residency.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":5,"max":10},"onlineAvailable":true,"fee":{"amount":75,"currency":"EUR"}}},{"countryCode":"EE","countryName":"Estonia","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":3504,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"First EU digital nomad visa programme (launched 2020). Type D: up to 1 year. Type C: up to 90 days."},"stayDuration":{"months":12,"renewable":false,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Estonian income tax (20% flat rate above threshold). Short stays below 183 days may not trigger tax residency.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":60},"onlineAvailable":true,"fee":{"amount":100,"currency":"EUR"}}},{"countryCode":"IT","countryName":"Italy","visaName":"Digital Nomad / Remote Worker Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":2750,"currency":"EUR","period":"monthly","usdEquivalent":3000,"basis":"income","notes":"Approximate threshold €2,700–€2,800/month. Family co-residence permitted."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Italian progressive tax rates apply. A separate flat-tax regime for new residents (€100,000 annual substitute tax) may be available independently.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":90},"onlineAvailable":false,"fee":{"amount":116,"currency":"EUR"}}},{"countryCode":"DE","countryName":"Germany","visaName":"Freiberufler (Freelance) Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":0,"currency":"EUR","period":"monthly","usdEquivalent":0,"basis":"none","notes":"No fixed income threshold. Demonstrable freelance or professional income sufficient to cover living costs required. Artist and professional tracks available."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard German progressive tax rates (15%–45% plus solidarity surcharge). Tax residency established once you have a habitual abode in Germany.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":90},"onlineAvailable":false,"fee":{"amount":75,"currency":"EUR"}}},{"countryCode":"RO","countryName":"Romania","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3700,"currency":"EUR","period":"monthly","usdEquivalent":4000,"basis":"income","notes":"Approximate threshold €3,600–€3,800/month. Romania joined Schengen in 2024."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Romanian income tax (10% flat rate — one of the lowest in the EU).","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":60},"onlineAvailable":true,"fee":{"amount":40,"currency":"EUR"}}},{"countryCode":"BG","countryName":"Bulgaria","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true}],"_note":"Response truncated for documentation purposes"}
List Visa Programs — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26224/list+visa+programs?region=europe' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns the full program object for a single country, identified by its ISO 3166-1 alpha-2 code (case-insensitive).

Endpoint ID: 26225
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26225/get+visa+program+by+country
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3480,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"4x Portuguese minimum wage"},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"NHR scheme abolished January 2024. Standard Portuguese progressive tax rates apply.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"25% per dependant","dependantUpliftPercent":25},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":20,"max":60},"onlineAvailable":true,"fee":{"amount":90,"currency":"EUR"}}},"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false}}
Get Visa Program by Country — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26225/get+visa+program+by+country&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns a normalised application checklist for one country: each requirement with a required flag and a human-readable detail string, plus processing time, fee, and online-availability.

Endpoint ID: 26226
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26226/get+application+requirements
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","checklist":[{"requirement":"Health Insurance","required":true,"detail":"Comprehensive health insurance valid in the host country required"},{"requirement":"Clean Criminal Record","required":true,"detail":"Official background check / criminal record certificate required"},{"requirement":"Proof of Accommodation","required":true,"detail":"Rental agreement, property deed, or hotel booking required"},{"requirement":"Proof of Remote Work","required":true,"detail":"Employment contract, client contracts, or business registration demonstrating remote-work arrangement required"},{"requirement":"Bank Statements","required":true,"detail":"Minimum 3 months of bank statements required"},{"requirement":"Dependants Allowed","required":false,"detail":"Family members may accompany the primary applicant; income uplift: 25% per dependant"}],"processing":{"min":20,"max":60},"fee":{"amount":90,"currency":"EUR"},"onlineAvailable":true,"dependantIncomeAdd":"25% per dependant","partial":false},"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false}}
Get Application Requirements — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26226/get+application+requirements&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns all programs in a single region. Valid regions: europe, asia, americas, africa, caribbean, oceania.

Endpoint ID: 26227
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26227/list+programs+by+region
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

API EXAMPLE RESPONSE
JSON
{"success":true,"data":[{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3480,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"4x Portuguese minimum wage"},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"NHR scheme abolished January 2024. Standard Portuguese progressive tax rates apply.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"25% per dependant","dependantUpliftPercent":25},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":20,"max":60},"onlineAvailable":true,"fee":{"amount":90,"currency":"EUR"}}},{"countryCode":"ES","countryName":"Spain","visaName":"Digital Nomad Visa (DNV)","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":2762,"currency":"EUR","period":"monthly","usdEquivalent":3000,"basis":"income","notes":"200% of Spanish minimum wage. Beckham Law flat-rate tax opt-in available for up to 6 years."},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10},"taxRegime":{"type":"flat","rate":0.24,"foreignIncomeExempt":false,"requires183Day":false,"notes":"Beckham Law: 24% flat rate on income up to €600,000 for up to 6 years. Opt-in required within 6 months of first Spanish tax return.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"75% per dependant","dependantUpliftPercent":75},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":70,"currency":"EUR"}}},{"countryCode":"HR","countryName":"Croatia","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":2540,"currency":"EUR","period":"monthly","usdEquivalent":2700,"basis":"income","notes":"Lowest income threshold among EU digital nomad visa programmes."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% income tax on foreign-sourced income for digital nomad visa holders.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":30,"currency":"EUR"}}},{"countryCode":"GR","countryName":"Greece","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3500,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"Applicants committing to 2-year tax residency receive a 50% income tax reduction for the first 7 years."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":7},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Greek progressive tax rates apply. A 50% income tax reduction is available for the first 7 years for those committing to 2-year tax residency.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":5,"max":10},"onlineAvailable":true,"fee":{"amount":75,"currency":"EUR"}}},{"countryCode":"EE","countryName":"Estonia","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":3504,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"First EU digital nomad visa programme (launched 2020). Type D: up to 1 year. Type C: up to 90 days."},"stayDuration":{"months":12,"renewable":false,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Estonian income tax (20% flat rate above threshold). Short stays below 183 days may not trigger tax residency.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":60},"onlineAvailable":true,"fee":{"amount":100,"currency":"EUR"}}},{"countryCode":"IT","countryName":"Italy","visaName":"Digital Nomad / Remote Worker Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":2750,"currency":"EUR","period":"monthly","usdEquivalent":3000,"basis":"income","notes":"Approximate threshold €2,700–€2,800/month. Family co-residence permitted."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Italian progressive tax rates apply. A separate flat-tax regime for new residents (€100,000 annual substitute tax) may be available independently.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":90},"onlineAvailable":false,"fee":{"amount":116,"currency":"EUR"}}},{"countryCode":"DE","countryName":"Germany","visaName":"Freiberufler (Freelance) Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":0,"currency":"EUR","period":"monthly","usdEquivalent":0,"basis":"none","notes":"No fixed income threshold. Demonstrable freelance or professional income sufficient to cover living costs required. Artist and professional tracks available."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard German progressive tax rates (15%–45% plus solidarity surcharge). Tax residency established once you have a habitual abode in Germany.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":90},"onlineAvailable":false,"fee":{"amount":75,"currency":"EUR"}}},{"countryCode":"RO","countryName":"Romania","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3700,"currency":"EUR","period":"monthly","usdEquivalent":4000,"basis":"income","notes":"Approximate threshold €3,600–€3,800/month. Romania joined Schengen in 2024."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Romanian income tax (10% flat rate — one of the lowest in the EU).","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":60},"onlineAvailable":true,"fee":{"amount":40,"currency":"EUR"}}},{"countryCode":"BG","countryName":"Bulgaria","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true}],"_note":"Response truncated for documentation purposes"}
List Programs by Region — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26227/list+programs+by+region®ion=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Given a nationality and monthly income, returns every program the applicant qualifies for, sorted ascending by required income (no-income-requirement programs first). Matching is always performed on the USD-equivalent monthly income; the `currency` parameter affects display only. When `dependants` > 0, each program's required income is recalculated using its dependant uplift; where the uplift is unknown the program is still returned with a `dependantUpliftUnknown` flag. Deposit-based and unconfirmed-threshold programs are returned with `matchType: "conditional"` rather than implying an income match.

Endpoint ID: 26228
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26228/check+eligibility
INPUT PARAMETERS

Check Eligibility — Endpoint Features

Object Description
nationality Required Required. Applicant nationality as an ISO 3166-1 alpha-2 code.
income Required Required. Applicant monthly income (numeric).
currency Optional Optional. Currency for display context only (default USD). Does not affect matching.
dependants Optional Optional. Number of accompanying dependants (non-negative integer, default 0).
stay Optional Optional. Minimum required stay duration in months.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

nationality
income
currency
dependants
stay
API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"nationality":"ZA","incomeMonthlyUSD":3500,"currency":"USD","dependants":0,"matchCount":25,"programs":[{"countryCode":"DE","countryName":"Germany","visaName":"Freiberufler (Freelance) Visa","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":0,"currency":"EUR","period":"monthly","usdEquivalent":0,"basis":"none","notes":"No fixed income threshold. Demonstrable freelance or professional income sufficient to cover living costs required. Artist and professional tracks available."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard German progressive tax rates (15%–45% plus solidarity surcharge). Tax residency established once you have a habitual abode in Germany.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":30,"max":90},"onlineAvailable":false,"fee":{"amount":75,"currency":"EUR"}},"matchType":"eligible","incomeRequirement":"none","requiredIncomeUsd":0},{"countryCode":"GE","countryName":"Georgia","visaName":"Visa-Free Remote Work","region":"europe","costOfLiving":"budget","requiresApplication":false,"incomeThreshold":{"amount":0,"currency":"USD","period":"monthly","usdEquivalent":0,"basis":"none","notes":"No income requirement. Most nationalities may enter visa-free for up to 365 days. No formal application needed."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"Georgia uses a territorial tax system — foreign-sourced remote income is outside the Georgian tax base entirely. 0% on income earned from foreign clients or employers.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":false,"criminalRecord":false,"proofOfAccommodation":false,"proofOfRemoteWork":false,"minBankStatementMonths":0,"dependantsAllowed":true,"dependantIncomeAdd":"No income requirement for any applicant","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":0,"max":0},"onlineAvailable":false,"fee":{"amount":0,"currency":"USD"}},"matchType":"eligible","incomeRequirement":"none","requiredIncomeUsd":0},{"countryCode":"AL","countryName":"Albania","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":800,"currency":"EUR","period":"monthly","usdEquivalent":870,"basis":"income","notes":"Approximate; programme details subject to change. Data incomplete."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Albanian income tax. Full details pending.","usCitizenNote":null},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified","dependantUpliftPercent":null},"partial":true,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":45},"onlineAvailable":true,"fee":{"amount":30,"currency":"EUR"}},"matchType":"eligible","requiredIncomeUsd":870},{"countryCode":"CO","countryName":"Colombia","visaName":"Digital Nomad / Remote Worker Visa","region":"americas","costOfLiving":"budget","requiresApplication":true,"incomeThreshold":{"amount":1100,"currency":"USD","period":"monthly","usdEquivalent":1100,"basis":"income","notes":"One of the lowest income thresholds globally. Approximately USD 1,100/month."},"stayDuration":{"months":24,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"0% tax on foreign-sourced income earned outside Colombia. If resident 183+ days, Colombian-sourced income is taxed at standard progressive rates.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":52,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1100},{"countryCode":"EC","countryName":"Ecuador","visaName":"Digital Nomad Visa","region":"americas","costOfLiving":"budget","requiresApplication":true,"incomeThreshold":{"amount":1446,"currency":"USD","period":"monthly","usdEquivalent":1446,"basis":"income","notes":"3x Ecuador's Unified Basic Salary (approximately USD 1,446/month in 2026)."},"stayDuration":{"months":24,"renewable":true,"maxYears":4,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":3},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"Territorial tax system. Foreign-sourced income not taxed in Ecuador.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":450,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1446},{"countryCode":"MX","countryName":"Mexico","visaName":"Temporary Resident Visa (Remote Worker)","region":"americas","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":1500,"currency":"USD","period":"monthly","usdEquivalent":1500,"basis":"income","notes":"Approximate; ~USD 1,500/month. No dedicated digital nomad visa — uses the Temporary Resident route. Consulate requirements vary."},"stayDuration":{"months":12,"renewable":true,"maxYears":4,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"Territorial tax system. Foreign-sourced income is not taxed. Becoming a Mexican tax resident (183+ days) triggers standard progressive rates on locally-sourced income.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":false,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":false,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":10,"max":30},"onlineAvailable":false,"fee":{"amount":36,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1500},{"countryCode":"BR","countryName":"Brazil","visaName":"Digital Nomad Visa","region":"americas","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":1500,"currency":"USD","period":"monthly","usdEquivalent":1500,"basis":"income","notes":"USD 1,500/month OR proof of savings of at least USD 18,000 — unique savings alternative to income proof."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":4},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Brazilian progressive income tax rates apply once you become a tax resident (183+ days). Foreign income is taxable for Brazilian tax residents.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":20,"max":30},"onlineAvailable":true,"fee":{"amount":165,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1500},{"countryCode":"MU","countryName":"Mauritius","visaName":"Premium Travel Visa","region":"africa","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":1500,"currency":"USD","period":"monthly","usdEquivalent":1500,"basis":"income","notes":"USD 1,500/month. Premium Travel Visa for remote workers."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% tax on foreign-sourced income for Premium Travel Visa holders."}}]},"_note":"Response truncated for documentation purposes"}
Check Eligibility — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26228/check+eligibility?nationality=ZA&income=3500' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns all programs grouped by tax regime (exempt, flat, territorial, standard). Each regime includes a plain-English explanation, a count, and the programs that fall under it.

Endpoint ID: 26229
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26229/list+tax+regimes
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"exempt":{"displayName":"Tax Exempt","explanation":"Your foreign-sourced income is completely exempt from local personal income tax. You pay no local tax on remote earnings, regardless of amount or source. These programmes are the most attractive for high earners whose clients or employers are based outside the host country.","count":12,"programs":[{"countryCode":"HR","countryName":"Croatia","visaName":"Digital Nomad Visa","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% income tax on foreign-sourced income for digital nomad visa holders.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"AE","countryName":"United Arab Emirates","visaName":"Remote Work Visa (Dubai)","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% personal income tax in the UAE. No tax on foreign or locally-sourced income for individuals.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"TH","countryName":"Thailand","visaName":"Long-Term Resident Visa (LTR) — Work-from-Thailand","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"LTR visa holders are exempt from Thai income tax on foreign-sourced income. A special 17% flat rate applies only to income earned within Thailand.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"ID","countryName":"Indonesia","visaName":"Second Home Visa","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% income tax on foreign-sourced income for Second Home Visa holders. Foreign income remitted to Indonesia may have different treatment — consult a tax professional.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"MY","countryName":"Malaysia","visaName":"DE Rantau Digital Nomad Pass","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% tax on foreign-sourced income remitted to Malaysia under the DE Rantau programme.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"CR","countryName":"Costa Rica","visaName":"Rentista / Pensionado Visa (Remote Worker)","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% tax on foreign-sourced income. Costa Rica uses a territorial system — only Costa Rican-sourced income is taxed.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"BB","countryName":"Barbados","visaName":"Welcome Stamp","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% tax on foreign-sourced income for Welcome Stamp holders. Barbados does not tax income earned outside the country.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"MU","countryName":"Mauritius","visaName":"Premium Travel Visa","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% tax on foreign-sourced income for Premium Travel Visa holders.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"SC","countryName":"Seychelles","visaName":"Workcation Visa","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"Foreign income generally not taxed. Full details pending. Data incomplete.","usCitizenNote":null}},{"countryCode":"BM","countryName":"Bermuda","visaName":"Work From Bermuda Certificate","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"No income tax in Bermuda. Full details pending.","usCitizenNote":null}},{"countryCode":"KY","countryName":"Cayman Islands","visaName":"Global Citizen Concierge Program","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"No income tax in the Cayman Islands. Full details pending.","usCitizenNote":null}},{"countryCode":"AG","countryName":"Antigua and Barbuda","visaName":"Nomad Digital Residence (NDR)","taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"No income tax in Antigua and Barbuda. Full details pending.","usCitizenNote":null}}]},"flat":{"displayName":"Flat Rate","explanation":"A single flat tax rate applies to your income, typically much lower than the standard progressive rates paid by local residents. You know exactly what percentage you will owe. For example, Spain's Beckham Law applies a 24% flat rate on income up to €600,000 for up to 6 years.","count":1,"programs":[{"countryCode":"ES","countryName":"Spain","visaName":"Digital Nomad Visa (DNV)","taxRegime":{"type":"flat","rate":0.24,"foreignIncomeExempt":false,"requires183Day":false,"notes":"Beckham Law: 24% flat rate on income up to €600,000 for up to 6 years. Opt-in required within 6 months of first Spanish tax return.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}}]},"territorial":{"displayName":"Territorial","explanation":"Only income earned within the country is subject to local tax. Foreign-sourced remote income — money paid to you by clients or employers outside the host country — is generally untaxed. If you earn money locally while living there, that income is taxed at standard rates. This regime is common across Latin America.","count":6,"programs":[{"countryCode":"GE","countryName":"Georgia","visaName":"Visa-Free Remote Work","taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"Georgia uses a territorial tax system — foreign-sourced remote income is outside the Georgian tax base entirely. 0% on income earned from foreign clients or employers.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"MX","countryName":"Mexico","visaName":"Temporary Resident Visa (Remote Worker)","taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"Territorial tax system. Foreign-sourced income is not taxed. Becoming a Mexican tax resident (183+ days) triggers standard progressive rates on locally-sourced income.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"CO","countryName":"Colombia","visaName":"Digital Nomad / Remote Worker Visa","taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"0% tax on foreign-sourced income earned outside Colombia. If resident 183+ days, Colombian-sourced income is taxed at standard progressive rates.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"EC","countryName":"Ecuador","visaName":"Digital Nomad Visa","taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"Territorial tax system. Foreign-sourced income not taxed in Ecuador.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"PA","countryName":"Panama","visaName":"Short Stay Visa (Remote Worker)","taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"Territorial tax system. Foreign-sourced income not taxed in Panama. Full details pending.","usCitizenNote":null}},{"countryCode":"PE","countryName":"Peru","visaName":"Digital Nomad Visa","taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"Territorial tax system. Foreign-sourced income generally not taxed. Full details pending.","usCitizenNote":null}}]},"standard":{"displayName":"Standard Progressive","explanation":"Standard progressive income tax rates apply, the same as those paid by local residents. Rates and bracket thresholds vary by country. Tax residency is typically triggered once you spend 183 or more days in the country in a calendar year. The headline visa income requirement and the local tax burden are separate considerations.","count":16,"programs":[{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"NHR scheme abolished January 2024. Standard Portuguese progressive tax rates apply.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"GR","countryName":"Greece","visaName":"Digital Nomad Visa","taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Greek progressive tax rates apply. A 50% income tax reduction is available for the first 7 years for those committing to 2-year tax residency.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"EE","countryName":"Estonia","visaName":"Digital Nomad Visa","taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Estonian income tax (20% flat rate above threshold). Short stays below 183 days may not trigger tax residency.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."}},{"countryCode":"IT","countryName":"Italy","visaName":"Digital Nomad / Remote Worker Visa","taxRegime":{"type":"standard","rate":null}}]}},"_note":"Response truncated for documentation purposes"}
List Tax Regimes — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26229/list+tax+regimes' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns the tax regime detail for one country: regime type, flat rate (if applicable), foreign-income exemption, 183-day rule applicability, and a US-citizen note.

Endpoint ID: 26230
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26230/get+tax+detail
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"NHR scheme abolished January 2024. Standard Portuguese progressive tax rates apply."},"usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status.","partial":false},"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false}}
Get Tax Detail — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26230/get+tax+detail&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Estimates tax on a given monthly income — but only where the regime makes it deterministic. Exempt regimes return 0; territorial regimes return 0 on foreign income (with a note that locally-sourced income is taxed normally); flat regimes return rate x income. Standard progressive regimes deliberately return `estimated: false` with no number, because a reliable figure depends on residency, deductions, and brackets. Always indicative, never tax advice.

Endpoint ID: 26231
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26231/estimate+tax
INPUT PARAMETERS

Estimate Tax — Endpoint Features

Object Description
income Required Required. Monthly income to estimate tax on (numeric).
currency Optional Optional. Currency for display context only (default USD).
countryCode Required

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

income
currency
API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"countryCode":"PT","countryName":"Portugal","incomeMonthlyUSD":3500,"taxRegimeType":"standard","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status.","disclaimer":"This is an indicative estimate only, not tax advice. Tax laws change frequently and individual circumstances vary. Consult a qualified tax professional before making decisions.","estimated":false,"note":"Standard progressive income tax rates apply. These vary by income bracket and individual circumstances. No estimate is provided for progressive regimes — consult a qualified tax professional for a personalised calculation.","currency":"USD"},"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false,"currencyNote":"Income and tax figures are in USD. The currency parameter is for display context only."}}
Estimate Tax — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26231/estimate+tax?income=3500&countryCode=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns only programs that offer a path to permanent residency and/or citizenship, sorted by speed (fewest years to citizenship first; programs without a year figure sort last).

Endpoint ID: 26232
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26232/list+residency+pathways
INPUT PARAMETERS

List Residency Pathways — Endpoint Features

Object Description
type Optional Optional. Filter: pr (PR-path only), citizenship (citizenship-path only). Omit for either.

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

type
API EXAMPLE RESPONSE
JSON
{"success":true,"data":[{"countryCode":"EC","countryName":"Ecuador","visaName":"Digital Nomad Visa","region":"americas","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":3,"maxYears":4,"partial":false},{"countryCode":"BR","countryName":"Brazil","visaName":"Digital Nomad Visa","region":"americas","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":4,"maxYears":null,"partial":false},{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5,"maxYears":5,"partial":false},{"countryCode":"MX","countryName":"Mexico","visaName":"Temporary Resident Visa (Remote Worker)","region":"americas","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5,"maxYears":4,"partial":false},{"countryCode":"BG","countryName":"Bulgaria","visaName":"Digital Nomad Visa","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5,"maxYears":null,"partial":false},{"countryCode":"CO","countryName":"Colombia","visaName":"Digital Nomad / Remote Worker Visa","region":"americas","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5,"maxYears":null,"partial":false},{"countryCode":"GR","countryName":"Greece","visaName":"Digital Nomad Visa","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":7,"maxYears":null,"partial":false},{"countryCode":"CR","countryName":"Costa Rica","visaName":"Rentista / Pensionado Visa (Remote Worker)","region":"americas","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":7,"maxYears":null,"partial":false},{"countryCode":"DE","countryName":"Germany","visaName":"Freiberufler (Freelance) Visa","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8,"maxYears":null,"partial":false},{"countryCode":"RO","countryName":"Romania","visaName":"Digital Nomad Visa","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":8,"maxYears":null,"partial":false},{"countryCode":"ES","countryName":"Spain","visaName":"Digital Nomad Visa (DNV)","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10,"maxYears":5,"partial":false},{"countryCode":"IT","countryName":"Italy","visaName":"Digital Nomad / Remote Worker Visa","region":"europe","pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10,"maxYears":null,"partial":false}],"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false,"count":12,"filter":"both"}}
List Residency Pathways — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26232/list+residency+pathways?type=citizenship-path only' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns a side-by-side comparison of 2–5 programs. Unrecognised codes are returned in a `notFound` array rather than failing the request. No ranking or winner is implied — this is a structured comparison only.

Endpoint ID: 26233
POST https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26233/compare+programs
INPUT PARAMETERS

Compare Programs — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"requested":["PT","ES","HR"],"notFound":[],"programs":[{"countryCode":"PT","countryName":"Portugal","visaName":"D8 Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":3480,"currency":"EUR","period":"monthly","usdEquivalent":3800,"basis":"income","notes":"4x Portuguese minimum wage"},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"NHR scheme abolished January 2024. Standard Portuguese progressive tax rates apply.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"25% per dependant","dependantUpliftPercent":25},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":20,"max":60},"onlineAvailable":true,"fee":{"amount":90,"currency":"EUR"}}},{"countryCode":"ES","countryName":"Spain","visaName":"Digital Nomad Visa (DNV)","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":2762,"currency":"EUR","period":"monthly","usdEquivalent":3000,"basis":"income","notes":"200% of Spanish minimum wage. Beckham Law flat-rate tax opt-in available for up to 6 years."},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10},"taxRegime":{"type":"flat","rate":0.24,"foreignIncomeExempt":false,"requires183Day":false,"notes":"Beckham Law: 24% flat rate on income up to €600,000 for up to 6 years. Opt-in required within 6 months of first Spanish tax return.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"75% per dependant","dependantUpliftPercent":75},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":70,"currency":"EUR"}}},{"countryCode":"HR","countryName":"Croatia","visaName":"Digital Nomad Visa","region":"europe","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":2540,"currency":"EUR","period":"monthly","usdEquivalent":2700,"basis":"income","notes":"Lowest income threshold among EU digital nomad visa programmes."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% income tax on foreign-sourced income for digital nomad visa holders.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":30,"currency":"EUR"}}}]},"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false}}
Compare Programs — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26233/compare+programs' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "countries": ["PT", "ES", "HR"]
}'

    
Request

Ranks the programs an applicant is eligible for against their stated priorities, returning a 0–100 score and a human-readable `reasons` array for each. Scoring is deterministic and explainable (weighted sub-scores, no ML). Only confirmed-eligible programs are scored; conditional matches (deposit-based or unconfirmed) are listed under `notScored`. `priorities` keys (lowTax, fastProcessing, lowCostOfLiving, pathToCitizenship, longStay) may be booleans or numeric weights; omit `priorities` to weight all five equally.

Endpoint ID: 26234
POST https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26234/recommend+programs
INPUT PARAMETERS

Recommend Programs — Endpoint Features

Object Description
Request Body Required Json

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"nationality":"ZA","incomeMonthlyUSD":3500,"currency":"USD","dependants":0,"appliedPriorities":{"lowTax":0.2,"fastProcessing":0.2,"lowCostOfLiving":0.2,"pathToCitizenship":0.2,"longStay":0.2},"resultCount":10,"programs":[{"countryCode":"EC","countryName":"Ecuador","visaName":"Digital Nomad Visa","region":"americas","costOfLiving":"budget","requiresApplication":true,"incomeThreshold":{"amount":1446,"currency":"USD","period":"monthly","usdEquivalent":1446,"basis":"income","notes":"3x Ecuador's Unified Basic Salary (approximately USD 1,446/month in 2026)."},"stayDuration":{"months":24,"renewable":true,"maxYears":4,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":3},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"Territorial tax system. Foreign-sourced income not taxed in Ecuador.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":450,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1446,"score":87.5,"reasons":["0% tax on foreign-sourced income (territorial system)","Processing in up to 30 days","Budget cost of living","Path to citizenship in 3 years","Up to 4-year stay"]},{"countryCode":"MX","countryName":"Mexico","visaName":"Temporary Resident Visa (Remote Worker)","region":"americas","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":1500,"currency":"USD","period":"monthly","usdEquivalent":1500,"basis":"income","notes":"Approximate; ~USD 1,500/month. No dedicated digital nomad visa — uses the Temporary Resident route. Consulate requirements vary."},"stayDuration":{"months":12,"renewable":true,"maxYears":4,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"Territorial tax system. Foreign-sourced income is not taxed. Becoming a Mexican tax resident (183+ days) triggers standard progressive rates on locally-sourced income.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":false,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":false,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":10,"max":30},"onlineAvailable":false,"fee":{"amount":36,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1500,"score":81.5,"reasons":["0% tax on foreign-sourced income (territorial system)","Processing in up to 30 days","Moderate cost of living","Path to citizenship in 5 years","Up to 4-year stay"]},{"countryCode":"CO","countryName":"Colombia","visaName":"Digital Nomad / Remote Worker Visa","region":"americas","costOfLiving":"budget","requiresApplication":true,"incomeThreshold":{"amount":1100,"currency":"USD","period":"monthly","usdEquivalent":1100,"basis":"income","notes":"One of the lowest income thresholds globally. Approximately USD 1,100/month."},"stayDuration":{"months":24,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":5},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":true,"notes":"0% tax on foreign-sourced income earned outside Colombia. If resident 183+ days, Colombian-sourced income is taxed at standard progressive rates.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":52,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1100,"score":79.5,"reasons":["0% tax on foreign-sourced income (territorial system)","Processing in up to 30 days","Budget cost of living","Path to citizenship in 5 years"]},{"countryCode":"ES","countryName":"Spain","visaName":"Digital Nomad Visa (DNV)","region":"europe","costOfLiving":"high","requiresApplication":true,"incomeThreshold":{"amount":2762,"currency":"EUR","period":"monthly","usdEquivalent":3000,"basis":"income","notes":"200% of Spanish minimum wage. Beckham Law flat-rate tax opt-in available for up to 6 years."},"stayDuration":{"months":12,"renewable":true,"maxYears":5,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":10},"taxRegime":{"type":"flat","rate":0.24,"foreignIncomeExempt":false,"requires183Day":false,"notes":"Beckham Law: 24% flat rate on income up to €600,000 for up to 6 years. Opt-in required within 6 months of first Spanish tax return.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":true,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"75% per dependant","dependantUpliftPercent":75},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":15,"max":30},"onlineAvailable":true,"fee":{"amount":70,"currency":"EUR"}},"matchType":"eligible","requiredIncomeUsd":3000,"score":67.5,"reasons":["Processing in up to 30 days","Path to citizenship in 10 years","Up to 5-year stay"]},{"countryCode":"GE","countryName":"Georgia","visaName":"Visa-Free Remote Work","region":"europe","costOfLiving":"budget","requiresApplication":false,"incomeThreshold":{"amount":0,"currency":"USD","period":"monthly","usdEquivalent":0,"basis":"none","notes":"No income requirement. Most nationalities may enter visa-free for up to 365 days. No formal application needed."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"territorial","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"Georgia uses a territorial tax system — foreign-sourced remote income is outside the Georgian tax base entirely. 0% on income earned from foreign clients or employers.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":false,"criminalRecord":false,"proofOfAccommodation":false,"proofOfRemoteWork":false,"minBankStatementMonths":0,"dependantsAllowed":true,"dependantIncomeAdd":"No income requirement for any applicant","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":0,"max":0},"onlineAvailable":false,"fee":{"amount":0,"currency":"USD"}},"matchType":"eligible","incomeRequirement":"none","requiredIncomeUsd":0,"score":60,"reasons":["0% tax on foreign-sourced income (territorial system)","No application processing required (visa-free entry)","Budget cost of living"]},{"countryCode":"BR","countryName":"Brazil","visaName":"Digital Nomad Visa","region":"americas","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":1500,"currency":"USD","period":"monthly","usdEquivalent":1500,"basis":"income","notes":"USD 1,500/month OR proof of savings of at least USD 18,000 — unique savings alternative to income proof."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":true,"pathToCitizenship":true,"citizenshipAfterYears":4},"taxRegime":{"type":"standard","rate":null,"foreignIncomeExempt":false,"requires183Day":true,"notes":"Standard Brazilian progressive income tax rates apply once you become a tax resident (183+ days). Foreign income is taxable for Brazilian tax residents.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":true,"proofOfAccommodation":false,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true,"dependantIncomeAdd":"Not publicly specified; contact relevant embassy","dependantUpliftPercent":null},"partial":false,"lastUpdated":"2026-06-01","application":{"processingDays":{"min":20,"max":30},"onlineAvailable":true,"fee":{"amount":165,"currency":"USD"}},"matchType":"eligible","requiredIncomeUsd":1500,"score":57.5,"reasons":["Processing in up to 30 days","Moderate cost of living","Path to citizenship in 4 years"]},{"countryCode":"MU","countryName":"Mauritius","visaName":"Premium Travel Visa","region":"africa","costOfLiving":"moderate","requiresApplication":true,"incomeThreshold":{"amount":1500,"currency":"USD","period":"monthly","usdEquivalent":1500,"basis":"income","notes":"USD 1,500/month. Premium Travel Visa for remote workers."},"stayDuration":{"months":12,"renewable":true,"maxYears":null,"pathToPR":false,"pathToCitizenship":false,"citizenshipAfterYears":null},"taxRegime":{"type":"exempt","rate":null,"foreignIncomeExempt":true,"requires183Day":false,"notes":"0% tax on foreign-sourced income for Premium Travel Visa holders.","usCitizenNote":"US citizens remain liable for US taxes on worldwide income regardless of visa status."},"requirements":{"healthInsurance":true,"criminalRecord":false,"proofOfAccommodation":false,"proofOfRemoteWork":true,"minBankStatementMonths":3,"dependantsAllowed":true}}]},"_note":"Response truncated for documentation purposes"}
Recommend Programs — CODE SNIPPETS

curl --location --request POST 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26234/recommend+programs' --header 'Authorization: Bearer YOUR_API_KEY' 

--data-raw '{
  "nationality": "ZA",
  "income": 3500
}'

    
Request

Returns live aggregate statistics computed from the dataset: counts by region, tax regime, and cost-of-living band; zero-tax and residency-pathway counts; the lowest confirmed income threshold; and the fastest confirmed processing time.

Endpoint ID: 26235
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26235/dataset+statistics
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{"success":true,"data":{"totalPrograms":35,"partialPrograms":11,"countByRegion":{"europe":13,"asia":7,"americas":8,"caribbean":4,"africa":3},"countByTaxRegime":{"standard":16,"flat":1,"exempt":12,"territorial":6},"countByCostOfLiving":{"moderate":13,"high":10,"premium":5,"budget":7},"zeroTaxPrograms":18,"pathToPRPrograms":12,"pathToCitizenshipPrograms":12,"lowestIncomeThreshold":{"usdEquivalent":1100,"countryCode":"CO","countryName":"Colombia"},"fastestProcessing":{"maxDays":10,"countryCode":"GR","countryName":"Greece"},"configLastUpdated":"2026-06-01"},"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false}}
Dataset Statistics — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26235/dataset+statistics' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns the program update history, newest first, so subscribers can detect changes without re-fetching all data. Supports optional filtering by country and by date.

Endpoint ID: 26236
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26236/get+changelog
INPUT PARAMETERS

Get Changelog — Endpoint Features

Object Description
countryCode Optional Optional. Filter to a single country (ISO 3166-1 alpha-2).
since Optional Optional. Return only entries on or after this date (YYYY-MM-DD).

Free test requests remaining: 3 of 3.


INPUT PARAMETERS

countryCode
since
API EXAMPLE RESPONSE
JSON
{"success":true,"data":[{"date":"2026-01-01","countryCode":"AE","change":"Bank statement requirement increased from 3 months to 6 months for UAE Remote Work Visa (Dubai)."},{"date":"2026-01-01","countryCode":"BG","change":"Bulgaria launched a new Digital Nomad Visa programme with an annual income threshold of €31,000."},{"date":"2025-01-01","countryCode":"BG","change":"Bulgaria adopted the Euro, joining the Eurozone."},{"date":"2024-03-31","countryCode":"RO","change":"Romania joined the Schengen Area (air and sea borders), enabling passport-free travel within Schengen."},{"date":"2024-03-31","countryCode":"BG","change":"Bulgaria joined the Schengen Area (air and sea borders)."},{"date":"2024-01-01","countryCode":"PT","change":"Portugal's NHR (Non-Habitual Resident) tax scheme abolished. Standard Portuguese progressive tax rates now apply to new digital nomad visa holders."}],"meta":{"disclaimer":"Visa requirements, income thresholds, and tax rules change frequently. Always verify current requirements with official government immigration sources before applying.","cached":false,"count":6}}
Get Changelog — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26236/get+changelog?countryCode=PT&since=2026-01-01' --header 'Authorization: Bearer YOUR_API_KEY' 


    
Request

Returns service status, uptime, version, total and partial program counts, and the config last-updated date. This endpoint is intentionally public (exempt from origin gateway-secret checks) so platform health monitors can reach it.

Endpoint ID: 26237
GET https://docs.zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26237/health+check
INPUT PARAMETERS

Free test requests remaining: 3 of 3.

This endpoint does not require any input parameters.

API EXAMPLE RESPONSE
JSON
{"status":"ok","uptime":159416.80052595,"version":"1.0.0","totalPrograms":35,"partialPrograms":11,"configLastUpdated":"2026-06-01"}
Health Check — CODE SNIPPETS

curl --location --request GET 'https://zylalabs.com/api/13039/global+digital+nomad+visa+intelligence+api/26237/health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API Access Key & Authentication

After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Global Digital Nomad Visa Intelligence API simply include your bearer token in the Authorization header.

Headers
Header Description
Authorization Required Should be Bearer access_key. See "Your API Access Key" above when you are subscribed.

No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.

(Save 2 months with annual billing 🎉)

🚀 Enterprise Plan

Starts at
$ 10,000/Year


  • Custom Volume
  • Custom Rate Limit
  • Specialized Customer Support
  • Real-Time API Monitoring
zeiss-logo amazon-logo zoom-logo decathlon-logo

Trusted by leading companies

Overview

The only structured REST API for global digital nomad and remote-work visa intelligence. The data exists everywhere else as scattered blog posts and PDFs — this API makes it machine-readable and computable.

What it does: Returns structured data for 35+ active programs across Europe, Asia, the Americas, Africa, and the Caribbean. Filterable by region, tax regime, income threshold, stay duration, residency path, processing speed, cost-of-living band, and dependant-friendly status.

What no wiki or blog can do: An eligibility engine that matches a nationality and monthly income (with dependant-adjusted thresholds) to every qualifying program. A scored recommendation engine that ranks programs 0–100 against an applicant's priorities — low tax, fast processing, low cost of living, path to citizenship, long stay — with plain-English reasons per result. A deterministic tax estimator that returns real figures for exempt, territorial, and flat-rate regimes, and honestly refuses to fake progressive ones. Residency and citizenship pathways sorted by speed. Per-country application-requirement checklists. Side-by-side program comparison.

Built for: HR and global employment platforms (Deel, Remote, Rippling-style), relocation services, immigration legal tech, remote job boards, travel and fintech apps serving location-independent earners.

Data: Curated from government immigration sources, updated quarterly. Every program carries a lastUpdated date. A /changelog endpoint lets subscribers detect updates without re-fetching the full dataset. Fully static — no database, no runtime scraping, fast and deterministic responses.

Global Digital Nomad Visa Intelligence API FAQs

Returns structured, machine-readable data for 35+ active digital nomad and remote-work visa programs worldwide. It covers eligibility matching, scored recommendations, tax detail and estimates, residency pathways, application requirement checklists, side-by-side comparison, dataset statistics, and a changelog — everything a blog post or wiki cannot compute.

Send a nationality (ISO country code) and monthly income to GET /eligible. The API returns every program the applicant qualifies for, sorted by required income ascending. All matching is done against a USD-equivalent monthly threshold so it works regardless of which currency a program quotes. Pass dependants=N to get family-adjusted income requirements per program.

POST /recommend ranks eligible programs 0–100 against an applicant's priorities — low tax, fast processing, low cost of living, path to citizenship, and long stay. Each result includes a plain-English reasons array explaining the score. Scoring is deterministic and fully explainable — no black-box ML. Only confirmed-eligible programs are ranked; deposit-based and unconfirmed programs are returned separately under notScored.

For exempt, territorial, and flat-rate regimes the tax owed is deterministic and the API returns a real figure. For standard progressive regimes, a reliable number depends on residency status, deductions, and bracket structure that vary per person — so the API returns estimated: false with guidance to consult a tax professional rather than returning a misleading number. Every estimate is indicative only and not tax advice.

Some programs have incomplete or unconfirmed data. Rather than drop them silently, the API always returns them with partial: true so consumers can decide how to treat them. Dataset statistics (GET /stats) only surface confirmed figures — for example, the lowest income threshold reported is the lowest confirmed one, not a placeholder.

The dataset is curated from government immigration sources and reviewed on a quarterly cycle. Every program carries a lastUpdated date. Use GET /changelog to detect what changed since your last fetch without re-pulling the full dataset — it supports ?since=YYYY-MM-DD and ?countryCode= filters.

Poll GET /changelog?since=YYYY-MM-DD on a schedule. It returns only entries on or after that date, newest first, so you can cheaply check for updates without re-fetching all 35 programs.

Some programs cannot be matched on monthly income — Indonesia's Second Home Visa requires a $130,000 bank deposit, and a handful of partial programs have unconfirmed thresholds. These are returned with matchType: conditional and a note explaining why, rather than being excluded entirely or falsely marked as income-eligible.

Yes — Georgia's visa-free entry has no income requirement at all and no formal application. It appears in eligibility results with matchType: eligible and incomeRequirement: none. Germany's Freiberufler visa also has no fixed threshold.

Each endpoint returns structured data related to digital nomad and remote-work visa programs. For example, the GET List Visa Programs endpoint provides a list of programs with details like income thresholds, stay duration, and tax regimes, while the GET Get Application Requirements endpoint returns a checklist of application requirements for a specific country.

Key fields in the response data include countryCode, visaName, incomeThreshold, stayDuration, taxRegime, and requirements. These fields provide essential information about each visa program, such as eligibility criteria and application details.

The response data is organized in a JSON format, with a success flag indicating the request status. Each program's details are encapsulated in a data object, which includes various attributes like income thresholds, processing times, and requirements, making it easy to parse and utilize.

Each endpoint provides specific information; for instance, GET List Tax Regimes offers tax regime classifications, while GET Check Eligibility returns programs based on nationality and income. This allows users to access tailored data relevant to their needs.

Parameters vary by endpoint; for example, GET List Visa Programs accepts filters like region, income, and sorting options. GET Check Eligibility requires nationality and income parameters, while GET List Programs by Region specifies valid regions like Europe or Asia.

Typical use cases include helping remote workers find suitable visa options based on their nationality and income, assisting HR platforms in managing global employment, and providing relocation services with detailed application requirements and tax implications.

Data accuracy is maintained by curating information from official government immigration sources and updating it quarterly. Each program includes a lastUpdated date, ensuring users access the most current and reliable information available.

When encountering partial results (indicated by partial: true), users should verify the completeness of the data before making decisions. For empty results, it may indicate no qualifying programs; users can adjust their parameters or check eligibility criteria for better matches.

General FAQs

To obtain your API key, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key to authenticate your requests.

You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.

The free trial lasts for 7 days and allows you to make up to 50 API requests.

No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.

Yes. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.

Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.

Prices are listed in USD (United States Dollar), EUR (Euro), CAD (Canadian Dollar), AUD (Australian Dollar), and GBP (British Pound). We accept all major debit and credit cards. Our payment system uses the latest security technology and is powered by Stripe, one of the world's most reliable payment companies. If you have any trouble paying by card, just contact us at [email protected]

Additionally, if you already have an active subscription in any of these currencies (USD, EUR, CAD, AUD, GBP), that currency will remain for subsequent subscriptions. You can change the currency at any time as long as you don't have any active subscriptions.
The local currency shown on the pricing page is based on the country of your IP address and is provided for reference only. The actual prices are in USD (United States Dollar). When you make a payment, the charge will appear on your card statement in USD, even if you see the equivalent amount in your local currency on our website. This means you cannot pay directly with your local currency.
Occasionally, a bank may decline the charge due to its fraud protection settings. We suggest reaching out to your bank initially to check if they are blocking our charges. Also, you can access the Billing Portal and change the card associated to make the payment. If these does not work and you need further assistance, please contact our team at [email protected]
Prices are determined by a recurring monthly or yearly subscription, depending on the chosen plan.
API calls are deducted from your plan based on successful requests. Each plan comes with a specific number of calls that you can make per month. Only successful calls, indicated by a Status 200 response, will be counted against your total. This ensures that failed or incomplete requests do not impact your monthly quota.
Zyla API Hub works on a recurring monthly subscription system. Your billing cycle will start the day you purchase one of the paid plans, and it will renew the same day of the next month. So be aware to cancel your subscription beforehand if you want to avoid future charges.
To upgrade your current subscription plan, simply go to the pricing page of the API and select the plan you want to upgrade to. The upgrade will be instant, allowing you to immediately enjoy the features of the new plan. Please note that any remaining calls from your previous plan will not be carried over to the new plan, so be aware of this when upgrading. You will be charged the full amount of the new plan.
To check how many API calls you have left for the current month, refer to the 'X-Zyla-API-Calls-Monthly-Remaining' field in the response header. For example, if your plan allows 1,000 requests per month and you've used 100, this field in the response header will indicate 900 remaining calls.

You can monitor your API usage through the response headers included with every request:

x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.

The 'X-Zyla-RateLimit-Reset' header shows the number of seconds until your rate limit resets. This tells you when your request count will start fresh. For example, if it displays 3,600, it means 3,600 seconds are left until the limit resets.

Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.

Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.

After 7 days, you will be charged the full amount for the plan you were subscribed to during the trial. Therefore, it's important to cancel before the trial period ends. Refund requests for forgetting to cancel on time are not accepted.
When you subscribe to an API free trial, you can make up to 50 API calls. If you wish to make additional API calls beyond this limit, the API will prompt you to perform an "Start Your Paid Plan." You can find the "Start Your Paid Plan" button in your profile under Subscription -> Choose the API you are subscribed to -> Pricing tab.
You can contact us through our chat channel to receive immediate assistance. We are always online from 8 am to 5 pm (EST). If you reach us after that time, we will get back to you as soon as possible. Additionally, you can contact us via email at [email protected]

Please have a look at our Refund Policy: https://zylalabs.com/terms#refund