v1

latestOpenAPI 3.0.3Commercial — see Terms2026-07-13274891.4 KB
Visa data

Full visa intelligence (32 data points)

The flagship endpoint. Returns the full VisaData object — documents, process, fees, embassies, transit visa, vaccinations, safety advisories, overstay penalties, and more — in 15 languages.

Plan gating:

  • free returns the core fields plus upgrade stubs; non-English requires Starter or above.
  • starter unlocks every extended field except remote_work_visa and reciprocity_history.
  • pro+ returns all 32 fields including bidirectional embassy info.

Counts against monthly quota.

get/api/v1/visa

Query parameters

passportstring required

ISO 3166-1 alpha-3 country code.

Example:FRA

ISO 3166-1 alpha-3 passport code, e.g. FRA.

destinationstring required

ISO 3166-1 alpha-3 country code.

Example:FRA

ISO 3166-1 alpha-3 destination code, e.g. JPN.

lang'en' | 'fr' | 'es' | 'pt' | 'de' | 'it' | 'ja' | 'ko' | 'zh' | 'ru' | 'ar' | 'hi' | 'th' | 'vi' | 'tl'
Example:en

Response language. Defaults to en. Non-English requires Starter or above.

Headers

Accept'application/json' | 'text/markdown'

Set to text/markdown for a human-readable Markdown rendering.

Response

Visa data successfully returned.

Example response

{
  "data": {
    "passport": "FRA",
    "destination": "FRA",
    "requirement": "visa_free",
    "visa_free_days": 90,
    "country_info": {
      "currency": "JPY",
      "language": "Japanese",
      "timezone": "UTC+9",
      "capital": "Tokyo"
    },
    "verified": true,
    "transit_visa": {
      "hubs": [
        {
          "airport": "NRT",
          "city": "Tokyo",
          "transit_free_hours": 24
        }
      ]
    },
    "passport_validity_months": 3,
    "visa_fee": {
      "single_entry": {
        "amount": 50,
        "currency": "USD"
      },
      "multiple_entry": {
        "amount": 50,
        "currency": "USD"
      }
    },
    "processing_days": {
      "standard": 5,
      "express": 2,
      "rush": 1
    },
    "photo_specs": {
      "width_mm": 35,
      "height_mm": 45,
      "background": "white",
      "head_covering_allowed": "religious only"
    },
    "insurance_required": {
      "required": true,
      "min_coverage": 30000,
      "currency": "EUR"
    },
    "minor_rules": {
      "solo_travel_min_age": 16,
      "single_parent_letter_required": true,
      "notarized_consent_required": true
    },
    "overstay_penalty": {
      "fine_per_day": "10 EUR",
      "ban_days": 365
    },
    "entry_by_mode": {
      "air": 90,
      "land": 30,
      "sea": 90
    },
    "remote_work_visa": {
      "available": true,
      "duration_months": 12,
      "fee": {
        "amount": 50,
        "currency": "USD"
      }
    },
    "extension_rules": {
      "possible": true,
      "max_days": 90,
      "fee": "free",
      "where": "Regional Immigration Office"
    },
    "reciprocity_history": [
      {
        "date": "2024-01-01",
        "from": "visa_required",
        "to": "visa_free"
      }
    ],
    "safety": {
      "level": 1,
      "advisory": "Exercise normal precautions",
      "source": "diplomatie.gouv.fr",
      "updated_at": "2026-04-12"
    }
  },
  "meta": {
    "lang": "en",
    "api_version": "1.1",
    "coverage": "199 x 199",
    "languages": 15,
    "data_points": 32
  }
}
All 27 operations