{"openapi":"3.1.0","info":{"title":"Visa Requirements API","version":"1.0.0","description":"Look up visa requirements between 199 passports and 199 destinations: whether a passport holder needs a visa, can enter visa-free, gets a visa on arrival, an e-visa or an eTA, or is not admitted — including the allowed length of stay in days. Get a full breakdown for any passport (every destination with category counts and a passport-power mobility score), the reverse view for any destination (which passports may enter), a ranking that compares the mobility of several passports, and the list of supported countries. Countries can be given as ISO-2, ISO-3 or exact name, and every endpoint accepts input via the query string or the request body. Pure server-side data (no third-party upstream), so responses are instant and always available. Ideal for travel-booking flows, relocation and immigration tools, fintech onboarding and travel apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/visa-api","description":"oanor gateway"}],"tags":[{"name":"Visa"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/compare":{"get":{"operationId":"get_v1_compare","tags":["Visa"],"summary":"Rank passports by mobility","description":"","parameters":[{"name":"passports","in":"query","required":true,"description":"Comma-separated countries (max 20)","schema":{"type":"string"},"example":"DE,US,JP,SG"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":4,"results":[{"rank":1,"passport":{"code":"DEU","iso2":"DE","name":"Germany","region":"Europe"},"by_category":{"eta":8,"e_visa":18,"visa_free":126,"visa_required":15,"visa_on_arrival":31},"mobility_score":183},{"rank":2,"passport":{"code":"JPN","iso2":"JP","name":"Japan","region":"Asia"},"by_category":{"eta":9,"e_visa":18,"visa_free":117,"visa_required":16,"visa_on_arrival":38},"mobility_score":182},{"rank":3,"passport":{"code":"SGP","iso2":"SG","name":"Singapore","region":"Asia"},"by_category":{"eta":8,"e_visa":16,"visa_free":130,"visa_required":17,"visa_on_arrival":27},"mobility_score":181},{"rank":4,"passport":{"code":"USA","iso2":"US","name":"United States","region":"Americas"},"by_category":{"eta":7,"e_visa":20,"visa_free":116,"visa_required":19,"visa_on_arrival":36},"mobility_score":179}]},"meta":{"timestamp":"2026-05-30T22:48:33.322Z","request_id":"a5054935-d652-4414-8937-eac191907307"},"status":"ok","message":"Comparison completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/countries":{"get":{"operationId":"get_v1_countries","tags":["Visa"],"summary":"All supported countries","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":199,"results":[{"code":"AFG","iso2":"AF","name":"Afghanistan","region":"Asia"},{"code":"AGO","iso2":"AO","name":"Angola","region":"Africa"},{"code":"ALB","iso2":"AL","name":"Albania","region":"Europe"},{"code":"AND","iso2":"AD","name":"Andorra","region":"Europe"},{"code":"ARE","iso2":"AE","name":"United Arab Emirates","region":"Asia"},{"code":"ARG","iso2":"AR","name":"Argentina","region":"Americas"},{"code":"ARM","iso2":"AM","name":"Armenia","region":"Asia"},{"code":"ATG","iso2":"AG","name":"Antigua and Barbuda","region":"Americas"},{"code":"AUS","iso2":"AU","name":"Australia","region":"Oceania"},{"code":"AUT","iso2":"AT","name":"Austria","region":"Europe"},{"code":"AZE","iso2":"AZ","name":"Azerbaijan","region":"Asia"},{"code":"BDI","iso2":"BI","name":"Burundi","region":"Africa"},{"code":"BEL","iso2":"BE","name":"Belgium","region":"Europe"},{"code":"BEN","iso2":"BJ","name":"Benin","region":"Africa"},{"code":"BFA","iso2":"BF","name":"Burkina Faso","region":"Africa"},{"code":"BGD","iso2":"BD","name":"Bangladesh","region":"Asia"},{"code":"BGR","iso2":"BG","name":"Bulgaria","region":"Europe"},{"code":"BHR","iso2":"BH","name":"Bahrain","region":"Asia"},{"code":"BHS","iso2":"BS","name":"Bahamas","region":"Americas"},{"code":"BIH","iso2":"BA","name":"Bosnia and Herzegovina","region":"Europe"},{"code":"BLR","iso2":"BY","name":"Belarus","region":"Europe"},{"code":"BLZ","iso2":"BZ","name":"Belize","region":"Americas"},{"code":"BOL","iso2":"BO","name":"Bolivia","region":"Americas"},{"code":"BRA","iso2":"BR","name":"Brazil","region":"Americas"},{"code":"BRB","iso2":"BB","name":"Barbados","region":"Americas"},{"code":"BRN","iso2":"BN","name":"Brunei","region":"Asia"},{"code":"BTN","iso2":"BT","name":"Bhutan","region":"Asia"},{"code":"BWA","iso2":"BW","name":"Botswana","region":"Africa"},{"code":"CAF","iso2":"CF","name":"Central African Republic","region":"Africa"},{"code":"CAN","iso2":"CA","name":"Canada","region":"Americas"},{"code":"CHE","iso2":"CH","name":"Switzerland","region":"Europe"},{"code":"CHL","iso2":"CL","name":"Chile","region":"Americas"},{"code":"CHN","iso2":"CN","name":"China","region":"Asia"},{"code":"CIV","iso2":"CI","name":"Ivory Coast","region":"Africa"},{"code":"CMR","iso2":"CM","name":"Cameroon","region":"Africa"},{"code":"COD","iso2":"CD","name":"DR Congo","region":"Africa"},{"code":"COG","iso2":"CG","name":"Congo","region":"Africa"},{"code":"COL","iso2":"CO","name":"Colombia","region":"Americas"},{"code":"COM","iso2":"KM","name":"Comoros","region":"Africa"},{"code":"CPV","iso2":"CV","name":"Cape Verde","region":"Africa"},{"code":"CRI","iso2":"CR","name":"Costa Rica","region":"Americas"},{"code":"CUB","iso2":"CU","name":"Cuba","region":"Americas"},{"code":"CYP","iso2":"CY","name":"Cyprus","region":"Europe"},{"code":"CZE","iso2":"CZ","name":"Czechia","region":"Europe"},{"code":"DEU","iso2":"DE","name":"Germany","region":"Europe"},{"code":"DJI","iso2":"DJ","name":"Djibouti","region":"Africa"},{"code":"DMA","iso2":"DM","name":"Dominica","region":"Americas"},{"code":"DNK","iso2":"DK","name":"Denmark","region":"Europe"},{"code":"DOM","iso2":"DO","name":"Dominican Republic","region":"Americas"},{"code":"DZA","iso2":"DZ","name":"Algeria","region":"Africa"},{"code":"ECU","iso2":"EC","name":"Ecuador","region":"Americas"},{"code":"EGY","iso2":"EG","name":"Egypt","region":"Africa"},{"code":"ERI","iso2":"ER","name":"Eritrea","region":"Africa"},{"code":"ESP","iso2":"ES","name":"Spain","region":"Europe"},{"code":"EST","iso2":"EE","name":"Estonia","region":"Europe"},{"code":"ETH","iso2":"ET","name":"Ethiopia","region":"Africa"},{"code":"FIN","iso2":"FI","name":"Finland","region":"Europe"},{"code":"FJI","iso2":"FJ","name":"Fiji","region":"Oceania"},{"code":"FRA","iso2":"FR","name":"France","region":"Europe"},{"code":"FSM","iso2":"FM","name":"Micronesia","region":"Oceania"},{"code":"GAB","iso2":"GA","name":"Gabon","region":"Africa"},{"code":"GBR","iso2":"GB","name":"United Kingdom","region":"Europe"},{"code":"GEO","iso2":"GE","name":"Georgia","region":"Asia"},{"code":"GHA","iso2":"GH","name":"Ghana","region":"Africa"},{"code":"GIN","iso2":"GN","name":"Guinea","region":"Africa"},{"code":"GMB","iso2":"GM","name":"Gambia","region":"Africa"},{"code":"GNB","iso2":"GW","name":"Guinea-Bissau","region":"Africa"},{"code":"GNQ","iso2":"GQ","name":"Equatorial Guinea","region":"Africa"},{"code":"GRC","iso2":"GR","name":"Greece","region":"Europe"},{"code":"GRD","iso2":"GD","name":"Grenada","region":"Americas"},{"code":"GTM","iso2":"GT","name":"Guatemala","region":"Americas"},{"code":"GUY","iso2":"GY","name":"Guyana","region":"Americas"},{"code":"HKG","iso2":"HK","name":"Hong Kong","region":"Asia"},{"code":"HND","iso2":"HN","name":"Honduras","region":"Americas"},{"code":"HRV","iso2":"HR","name":"Croatia","region":"Europe"},{"code":"HTI","iso2":"HT","name":"Haiti","region":"Americas"},{"code":"HUN","iso2":"HU","name":"Hungary","region":"Europe"},{"code":"IDN","iso2":"ID","name":"Indonesia","region":"Asia"},{"code":"IND","iso2":"IN","name":"India","region":"Asia"},{"code":"IRL","iso2":"IE","name":"Ireland","region":"Europe"},{"code":"IRN","iso2":"IR","name":"Iran","region":"Asia"},{"code":"IRQ","iso2":"IQ","name":"Iraq","region":"Asia"},{"code":"ISL","iso2":"IS","name":"Iceland","region":"Europe"},{"code":"ISR","iso2":"IL","name":"Israel","region":"Asia"},{"code":"ITA","iso2":"IT","name":"Italy","region":"Europe"},{"code":"JAM","iso2":"JM","name":"Jamaica","region":"Americas"},{"code":"JOR","iso2":"JO","name":"Jordan","region":"Asia"},{"code":"JPN","iso2":"JP","name":"Japan","region":"Asia"},{"code":"KAZ","iso2":"KZ","name":"Kazakhstan","region":"Asia"},{"code":"KEN","iso2":"KE","name":"Kenya","region":"Africa"},{"code":"KGZ","iso2":"KG","name":"Kyrgyzstan","region":"Asia"},{"code":"KHM","iso2":"KH","name":"Cambodia","region":"Asia"},{"code":"KIR","iso2":"KI","name":"Kiribati","region":"Oceania"},{"code":"KNA","iso2":"KN","name":"Saint Kitts and Nevis","region":"Americas"},{"code":"KOR","iso2":"KR","name":"South Korea","region":"Asia"},{"code":"KWT","iso2":"KW","name":"Kuwait","region":"Asia"},{"code":"LAO","iso2":"LA","name":"Laos","region":"Asia"},{"code":"LBN","iso2":"LB","name":"Lebanon","region":"Asia"},{"code":"LBR","iso2":"LR","name":"Liberia","region":"Africa"},{"code":"LBY","iso2":"LY","name":"Libya","region":"Africa"},{"code":"LCA","iso2":"LC","name":"Saint Lucia","region":"Americas"},{"code":"LIE","iso2":"LI","name":"Liechtenstein","region":"Europe"},{"code":"LKA","iso2":"LK","name":"Sri Lanka","region":"Asia"},{"code":"LSO","iso2":"LS","name":"Lesotho","region":"Africa"},{"code":"LTU","iso2":"LT","name":"Lithuania","region":"Europe"},{"code":"LUX","iso2":"LU","name":"Luxembourg","region":"Europe"},{"code":"LVA","iso2":"LV","name":"Latvia","region":"Europe"},{"code":"MAC","iso2":"MO","name":"Macau","region":"Asia"},{"code":"MAR","iso2":"MA","name":"Morocco","region":"Africa"},{"code":"MCO","iso2":"MC","name":"Monaco","region":"Europe"},{"code":"MDA","iso2":"MD","name":"Moldova","region":"Europe"},{"code":"MDG","iso2":"MG","name":"Madagascar","region":"Africa"},{"code":"MDV","iso2":"MV","name":"Maldives","region":"Asia"},{"code":"MEX","iso2":"MX","name":"Mexico","region":"Americas"},{"code":"MHL","iso2":"MH","name":"Marshall Islands","region":"Oceania"},{"code":"MKD","iso2":"MK","name":"North Macedonia","region":"Europe"},{"code":"MLI","iso2":"ML","name":"Mali","region":"Africa"},{"code":"MLT","iso2":"MT","name":"Malta","region":"Europe"},{"code":"MMR","iso2":"MM","name":"Myanmar","region":"Asia"},{"code":"MNE","iso2":"ME","name":"Montenegro","region":"Europe"},{"code":"MNG","iso2":"MN","name":"Mongolia","region":"Asia"},{"code":"MOZ","iso2":"MZ","name":"Mozambique","region":"Africa"},{"code":"MRT","iso2":"MR","name":"Mauritania","region":"Africa"},{"code":"MUS","iso2":"MU","name":"Mauritius","region":"Africa"},{"code":"MWI","iso2":"MW","name":"Malawi","region":"Africa"},{"code":"MYS","iso2":"MY","name":"Malaysia","region":"Asia"},{"code":"NAM","iso2":"NA","name":"Namibia","region":"Africa"},{"code":"NER","iso2":"NE","name":"Niger","region":"Africa"},{"code":"NGA","iso2":"NG","name":"Nigeria","region":"Africa"},{"code":"NIC","iso2":"NI","name":"Nicaragua","region":"Americas"},{"code":"NLD","iso2":"NL","name":"Netherlands","region":"Europe"},{"code":"NOR","iso2":"NO","name":"Norway","region":"Europe"},{"code":"NPL","iso2":"NP","name":"Nepal","region":"Asia"},{"code":"NRU","iso2":"NR","name":"Nauru","region":"Oceania"},{"code":"NZL","iso2":"NZ","name":"New Zealand","region":"Oceania"},{"code":"OMN","iso2":"OM","name":"Oman","region":"Asia"},{"code":"PAK","iso2":"PK","name":"Pakistan","region":"Asia"},{"code":"PAN","iso2":"PA","name":"Panama","region":"Americas"},{"code":"PER","iso2":"PE","name":"Peru","region":"Americas"},{"code":"PHL","iso2":"PH","name":"Philippines","region":"Asia"},{"code":"PLW","iso2":"PW","name":"Palau","region":"Oceania"},{"code":"PNG","iso2":"PG","name":"Papua New Guinea","region":"Oceania"},{"code":"POL","iso2":"PL","name":"Poland","region":"Europe"},{"code":"PRK","iso2":"KP","name":"North Korea","region":"Asia"},{"code":"PRT","iso2":"PT","name":"Portugal","region":"Europe"},{"code":"PRY","iso2":"PY","name":"Paraguay","region":"Americas"},{"code":"PSE","iso2":"PS","name":"Palestine","region":"Asia"},{"code":"QAT","iso2":"QA","name":"Qatar","region":"Asia"},{"code":"ROU","iso2":"RO","name":"Romania","region":"Europe"},{"code":"RUS","iso2":"RU","name":"Russia","region":"Europe"},{"code":"RWA","iso2":"RW","name":"Rwanda","region":"Africa"},{"code":"SAU","iso2":"SA","name":"Saudi Arabia","region":"Asia"},{"code":"SDN","iso2":"SD","name":"Sudan","region":"Africa"},{"code":"SEN","iso2":"SN","name":"Senegal","region":"Africa"},{"code":"SGP","iso2":"SG","name":"Singapore","region":"Asia"},{"code":"SLB","iso2":"SB","name":"Solomon Islands","region":"Oceania"},{"code":"SLE","iso2":"SL","name":"Sierra Leone","region":"Africa"},{"code":"SLV","iso2":"SV","name":"El Salvador","region":"Americas"},{"code":"SMR","iso2":"SM","name":"San Marino","region":"Europe"},{"code":"SOM","iso2":"SO","name":"Somalia","region":"Africa"},{"code":"SRB","iso2":"RS","name":"Serbia","region":"Europe"},{"code":"SSD","iso2":"SS","name":"South Sudan","region":"Africa"},{"code":"STP","iso2":"ST","name":"São Tomé and Príncipe","region":"Africa"},{"code":"SUR","iso2":"SR","name":"Suriname","region":"Americas"},{"code":"SVK","iso2":"SK","name":"Slovakia","region":"Europe"},{"code":"SVN","iso2":"SI","name":"Slovenia","region":"Europe"},{"code":"SWE","iso2":"SE","name":"Sweden","region":"Europe"},{"code":"SWZ","iso2":"SZ","name":"Eswatini","region":"Africa"},{"code":"SYC","iso2":"SC","name":"Seychelles","region":"Africa"},{"code":"SYR","iso2":"SY","name":"Syria","region":"Asia"},{"code":"TCD","iso2":"TD","name":"Chad","region":"Africa"},{"code":"TGO","iso2":"TG","name":"Togo","region":"Africa"},{"code":"THA","iso2":"TH","name":"Thailand","region":"Asia"},{"code":"TJK","iso2":"TJ","name":"Tajikistan","region":"Asia"},{"code":"TKM","iso2":"TM","name":"Turkmenistan","region":"Asia"},{"code":"TLS","iso2":"TL","name":"Timor-Leste","region":"Asia"},{"code":"TON","iso2":"TO","name":"Tonga","region":"Oceania"},{"code":"TTO","iso2":"TT","name":"Trinidad and Tobago","region":"Americas"},{"code":"TUN","iso2":"TN","name":"Tunisia","region":"Africa"},{"code":"TUR","iso2":"TR","name":"Türkiye","region":"Asia"},{"code":"TUV","iso2":"TV","name":"Tuvalu","region":"Oceania"},{"code":"TWN","iso2":"TW","name":"Taiwan","region":"Asia"},{"code":"TZA","iso2":"TZ","name":"Tanzania","region":"Africa"},{"code":"UGA","iso2":"UG","name":"Uganda","region":"Africa"},{"code":"UKR","iso2":"UA","name":"Ukraine","region":"Europe"},{"code":"URY","iso2":"UY","name":"Uruguay","region":"Americas"},{"code":"USA","iso2":"US","name":"United States","region":"Americas"},{"code":"UZB","iso2":"UZ","name":"Uzbekistan","region":"Asia"},{"code":"VAT","iso2":"VA","name":"Vatican City","region":"Europe"},{"code":"VCT","iso2":"VC","name":"Saint Vincent and the Grenadines","region":"Americas"},{"code":"VEN","iso2":"VE","name":"Venezuela","region":"Americas"},{"code":"VNM","iso2":"VN","name":"Vietnam","region":"Asia"},{"code":"VUT","iso2":"VU","name":"Vanuatu","region":"Oceania"},{"code":"WSM","iso2":"WS","name":"Samoa","region":"Oceania"},{"code":"XKX","iso2":"XK","name":"Kosovo","region":"Europe"},{"code":"YEM","iso2":"YE","name":"Yemen","region":"Asia"},{"code":"ZAF","iso2":"ZA","name":"South Africa","region":"Africa"},{"code":"ZMB","iso2":"ZM","name":"Zambia","region":"Africa"},{"code":"ZWE","iso2":"ZW","name":"Zimbabwe","region":"Africa"}]},"meta":{"timestamp":"2026-05-30T22:48:33.397Z","request_id":"d49e9f2a-be5a-4132-8750-5ba11161cea8"},"status":"ok","message":"Countries retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/destination":{"get":{"operationId":"get_v1_destination","tags":["Visa"],"summary":"Which passports may enter a destination","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"Destination country","schema":{"type":"string"},"example":"JP"},{"name":"category","in":"query","required":false,"description":"Filter category","schema":{"type":"string"},"example":"visa_free"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":71,"passports":[{"passport":{"code":"AND","iso2":"AD","name":"Andorra","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"ARG","iso2":"AR","name":"Argentina","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"AUS","iso2":"AU","name":"Australia","region":"Oceania"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"AUT","iso2":"AT","name":"Austria","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"BHS","iso2":"BS","name":"Bahamas","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"BRB","iso2":"BB","name":"Barbados","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"BEL","iso2":"BE","name":"Belgium","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"BRA","iso2":"BR","name":"Brazil","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"BRN","iso2":"BN","name":"Brunei","region":"Asia"},"requirement":{"code":"14","label":"visa-free (14 days)","category":"visa_free","allowed_days":14}},{"passport":{"code":"BGR","iso2":"BG","name":"Bulgaria","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"CAN","iso2":"CA","name":"Canada","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"CHL","iso2":"CL","name":"Chile","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"CRI","iso2":"CR","name":"Costa Rica","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"HRV","iso2":"HR","name":"Croatia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"CYP","iso2":"CY","name":"Cyprus","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"CZE","iso2":"CZ","name":"Czechia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"DNK","iso2":"DK","name":"Denmark","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"DOM","iso2":"DO","name":"Dominican Republic","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SLV","iso2":"SV","name":"El Salvador","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"EST","iso2":"EE","name":"Estonia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"FIN","iso2":"FI","name":"Finland","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"FRA","iso2":"FR","name":"France","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"DEU","iso2":"DE","name":"Germany","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"GRC","iso2":"GR","name":"Greece","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"GTM","iso2":"GT","name":"Guatemala","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"HND","iso2":"HN","name":"Honduras","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"HKG","iso2":"HK","name":"Hong Kong","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"HUN","iso2":"HU","name":"Hungary","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"ISL","iso2":"IS","name":"Iceland","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"IDN","iso2":"ID","name":"Indonesia","region":"Asia"},"requirement":{"code":"15","label":"visa-free (15 days)","category":"visa_free","allowed_days":15}},{"passport":{"code":"IRL","iso2":"IE","name":"Ireland","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"ISR","iso2":"IL","name":"Israel","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"ITA","iso2":"IT","name":"Italy","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"LVA","iso2":"LV","name":"Latvia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"LSO","iso2":"LS","name":"Lesotho","region":"Africa"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"LIE","iso2":"LI","name":"Liechtenstein","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"LTU","iso2":"LT","name":"Lithuania","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"LUX","iso2":"LU","name":"Luxembourg","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MAC","iso2":"MO","name":"Macau","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MYS","iso2":"MY","name":"Malaysia","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MLT","iso2":"MT","name":"Malta","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MUS","iso2":"MU","name":"Mauritius","region":"Africa"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MEX","iso2":"MX","name":"Mexico","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MCO","iso2":"MC","name":"Monaco","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"NLD","iso2":"NL","name":"Netherlands","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"NZL","iso2":"NZ","name":"New Zealand","region":"Oceania"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"MKD","iso2":"MK","name":"North Macedonia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"NOR","iso2":"NO","name":"Norway","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"PAN","iso2":"PA","name":"Panama","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"POL","iso2":"PL","name":"Poland","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"PRT","iso2":"PT","name":"Portugal","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"QAT","iso2":"QA","name":"Qatar","region":"Asia"},"requirement":{"code":"30","label":"visa-free (30 days)","category":"visa_free","allowed_days":30}},{"passport":{"code":"ROU","iso2":"RO","name":"Romania","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SMR","iso2":"SM","name":"San Marino","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SRB","iso2":"RS","name":"Serbia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SGP","iso2":"SG","name":"Singapore","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SVK","iso2":"SK","name":"Slovakia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SVN","iso2":"SI","name":"Slovenia","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"KOR","iso2":"KR","name":"South Korea","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"ESP","iso2":"ES","name":"Spain","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SUR","iso2":"SR","name":"Suriname","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"SWE","iso2":"SE","name":"Sweden","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"CHE","iso2":"CH","name":"Switzerland","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"TWN","iso2":"TW","name":"Taiwan","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"THA","iso2":"TH","name":"Thailand","region":"Asia"},"requirement":{"code":"15","label":"visa-free (15 days)","category":"visa_free","allowed_days":15}},{"passport":{"code":"TUN","iso2":"TN","name":"Tunisia","region":"Africa"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"TUR","iso2":"TR","name":"Türkiye","region":"Asia"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"ARE","iso2":"AE","name":"United Arab Emirates","region":"Asia"},"requirement":{"code":"30","label":"visa-free (30 days)","category":"visa_free","allowed_days":30}},{"passport":{"code":"GBR","iso2":"GB","name":"United Kingdom","region":"Europe"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"USA","iso2":"US","name":"United States","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}},{"passport":{"code":"URY","iso2":"UY","name":"Uruguay","region":"Americas"},"requirement":{"code":"90","label":"visa-free (90 days)","category":"visa_free","allowed_days":90}}],"by_category":{"e_visa":7,"visa_free":71,"no_admission":1,"visa_required":119},"destination":{"code":"JPN","iso2":"JP","name":"Japan","region":"Asia"},"mobility_score":78},"meta":{"timestamp":"2026-05-30T22:48:33.456Z","request_id":"42f27b8e-618d-4d99-bab7-a9184fb4e5fc"},"status":"ok","message":"Destination retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/passport":{"get":{"operationId":"get_v1_passport","tags":["Visa"],"summary":"All destinations for one passport","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"Passport country","schema":{"type":"string"},"example":"DEU"},{"name":"category","in":"query","required":false,"description":"Filter: visa_free|visa_on_arrival|e_visa|eta|visa_required|no_admission","schema":{"type":"string"},"example":"visa_required"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":15,"passport":{"code":"DEU","iso2":"DE","name":"Germany","region":"Europe"},"by_category":{"eta":8,"e_visa":18,"visa_free":126,"visa_required":15,"visa_on_arrival":31},"destinations":[{"destination":{"code":"AFG","iso2":"AF","name":"Afghanistan","region":"Asia"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"DZA","iso2":"DZ","name":"Algeria","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"CAF","iso2":"CF","name":"Central African Republic","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"TCD","iso2":"TD","name":"Chad","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"COG","iso2":"CG","name":"Congo","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"ERI","iso2":"ER","name":"Eritrea","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"LBR","iso2":"LR","name":"Liberia","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"MLI","iso2":"ML","name":"Mali","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"NRU","iso2":"NR","name":"Nauru","region":"Oceania"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"NER","iso2":"NE","name":"Niger","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"PRK","iso2":"KP","name":"North Korea","region":"Asia"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"SDN","iso2":"SD","name":"Sudan","region":"Africa"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"SUR","iso2":"SR","name":"Suriname","region":"Americas"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"TKM","iso2":"TM","name":"Turkmenistan","region":"Asia"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}},{"destination":{"code":"YEM","iso2":"YE","name":"Yemen","region":"Asia"},"requirement":{"code":"visa required","label":"visa required","category":"visa_required"}}],"mobility_score":183},"meta":{"timestamp":"2026-05-30T22:48:33.527Z","request_id":"f6dff952-ca3e-48d6-b228-6e93fefc4c01"},"status":"ok","message":"Passport retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/requirement":{"get":{"operationId":"get_v1_requirement","tags":["Visa"],"summary":"Visa rule for a passport → destination","description":"","parameters":[{"name":"from","in":"query","required":true,"description":"Passport country (ISO-2/3 or name)","schema":{"type":"string"},"example":"DE"},{"name":"to","in":"query","required":true,"description":"Destination country","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"to":{"code":"USA","iso2":"US","name":"United States","region":"Americas"},"from":{"code":"DEU","iso2":"DE","name":"Germany","region":"Europe"},"requirement":{"code":"eta","label":"electronic travel authorisation","category":"eta"}},"meta":{"timestamp":"2026-05-30T22:48:33.595Z","request_id":"f6058caa-786f-46bb-b63c-517078d281ea"},"status":"ok","message":"Requirement retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":25000,"rps_limit":3,"hard_limit":true},{"slug":"basic","name":"Basic","price_cents_month":550,"monthly_call_quota":350000,"rps_limit":12,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1700,"monthly_call_quota":2500000,"rps_limit":40,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4400,"monthly_call_quota":12000000,"rps_limit":120,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/visa-api"}