API Documentation

Integrate the Global Digital Nomad Visa Qualification Engine into your own platform.

Authentication

All production API requests must be authenticated using your oneisolve API Key as a Bearer Token.

Authorization: Bearer YOUR_API_KEY

Sandbox Environment (Free Test)

Test your integration for free without deducting from your quota. The sandbox returns dummy data.

Endpoint: POST https://oneisolve.com/api/v1/sandbox/qualify
Test Key: sk_test_12345

POST /api/v1/qualify

Evaluates a user's eligibility for global digital nomad visas based on their income and employment type.

Request Body (JSON)

{
  "monthly_income_usd": 4000,
  "employment_type": "remote_employee" // or "freelancer", "business_owner"
}

Example cURL

curl -X POST https://oneisolve.com/api/v1/qualify \
  -H "Authorization: Bearer YOUR_LICENSE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthly_income_usd": 4000, "employment_type": "remote_employee"}'

Response Structure

{
  "eligible_visas": [
    {
      "id": "spain-dnv",
      "country": "Spain",
      "match_score": 100,
      "tax_benefit": "Flat 24% tax rate under Beckham Law",
      "min_income_usd": 2300,
      "apply_url": "https://oneisolve.com/visa/spain-dnv"
    }
  ],
  "quota_remaining": 4999,
  "timestamp": "2026-09-05T12:00:00.000Z"
}

Error Codes

400 Bad Request (Missing parameters)
401 Unauthorized (Invalid License Key)
402 Payment Required (Quota Exceeded)
429 Too Many Requests (Rate limit: 20/sec)