latestOpenAPI 3.0.3Commercial — see Terms2026-08-122953115.6 KB

97ea5156ef11

Visa data

Group trip — multi-passport intersection (Hobby+)

Pass 2 to 10 passports and get back every destination reachable by all of them, with the per-passport breakdown and the group's worst-case requirement.

A destination qualifies when every passport is visa_free, eta, visa_on_arrival or e_visa — narrow or widen with allow (e.g. allow=visa_free for strictly visa-free). group_visa_free_days is the minimum allowed stay across the group, i.e. the binding constraint for a shared trip. Destinations are sorted easiest-first.

One group call counts as 1 request against your monthly quota.

Requires Hobby plan or above.

get/api/v1/visa/group

Query parameters

passportsstring required
Example:USA,FRA,IND

Comma-separated ISO3 list, 2 to 10 distinct codes.

allowstring
Example:visa_free,eta,visa_on_arrival,e_visa

Comma-separated requirement types that qualify.

Response

Destinations reachable by every passport in the group.

passportsISO3[] required
allowVisaRequirement[] required
totalinteger required

Example response

{
  "passports": [
    "USA",
    "FRA",
    "IND"
  ],
  "allow": [
    "visa_free"
  ],
  "total": 97,
  "excluded": {
    "requirement_not_allowed": 100,
    "incomplete_data": 4
  },
  "destinations": [
    {
      "destination": "FRA",
      "group_requirement": "visa_free",
      "group_visa_free_days": 120
    }
  ]
}