{"uid":"cap_-9sNk1soR2L4wWHlNx2qv","slug":"taxpulse-digital-nomad-tax-optimizer-63d47cc5","name":"TaxPulse Digital Nomad Tax Optimizer","description":"Digital nomad tax, territorial-tax countries, 183-day residency rule, tax residency by jurisdiction. Worldwide guide mapping zero/low-tax nomad destinations, where remote income is taxed, and the expat obligations that follow. Tax intelligence, not advice.","url":"https://taxpulse-phi.vercel.app/api/tax/nomad","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"lang":{"type":"string","description":"lang"},"focus":{"type":"string","description":"focus"},"income_type":{"type":"string","description":"remote employee | freelancer | entrepreneur | investor | content creator"},"nationality":{"type":"string","description":"e.g. American, British, Canadian, German — affects home country obligations"},"income_level":{"type":"string","description":"income_level"}}},"responseSchema":{"type":"json","example":{}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.12","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.12/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.12","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_cLKBP_-kJe4-2z2jlv5wy","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.12","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Maps territorial-tax jurisdictions, 183-day residency rules, and expat tax obligations for digital nomads","exampleAgentPrompt":"I'm a digital nomad planning to spend about 190 days in Portugal this year — can you check the 183-day residency rules, what territorial tax obligations kick in, and what expat duties I'd face as a US citizen living there?","exampleUseCases":[{"title":"Finding tax-friendly countries for remote work","prompt":"I'm looking to relocate with my remote job for the next 18 months. Can you help me identify countries with territorial tax systems where my foreign-source income won't be taxed, and tell me which ones let me stay up to 200 days without triggering residency?"},{"title":"Avoiding double taxation across borders","prompt":"I've been moving between Thailand, Indonesia, and Vietnam over the past year. Can you check each country's 183-day residency rules and territorial tax treatment for digital nomads so I understand where my freelance income is taxable and if I'm triggering any expat reporting obligations?"},{"title":"Planning a multi-country nomad year","prompt":"I want to spend 80 days in Mexico, 100 days in Colombia, and 60 days in Spain before returning home. Can you walk me through the 183-day residency thresholds in each country and flag any territorial tax obligations or FBAR/FATCA requirements I need to track?"}],"resultDescription":"Returns structured data on the target jurisdiction's territorial tax system, 183-day residency thresholds and triggers, applicable expat obligations (e.g. FBAR, FATCA, FEIE eligibility), and guidance on how foreign-source income is treated for nomads in that country.","failureModes":["Unsupported or unrecognized jurisdiction returns an error or empty result","Missing required query parameters (e.g. country code) returns a 400 Bad Request","Stale jurisdiction data if tax rules have recently changed","Rate limiting or payment failure returns 402 or 429 error","Ambiguous residency scenarios (split-year, multiple countries) may return incomplete guidance"],"whenToPreferThis":"Use this endpoint when an AI agent needs jurisdiction-specific digital nomad tax intelligence, especially around territorial taxation and 183-day residency thresholds. Prefer over generic country tax endpoints when the user's primary concern is nomadic lifestyle, multi-country movement, or triggering residency obligations. Use the dedicated expat obligations endpoint for deeper FBAR/FATCA detail, or the treaty analysis endpoint for withholding rates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:43:07.337Z","isFirstParty":false}