---
title: "Group trip — multi-passport intersection (Hobby+)"
method: GET
path: "/api/v1/visa/group"
tags: ["Visa data"]
---

# Group trip — multi-passport intersection (Hobby+)

`GET /api/v1/visa/group`

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.

## Query parameters

- `passports` string, required
- `allow` string

## Response `200`

Destinations reachable by every passport in the group.

- GroupResponse
  - `passports` ISO3[], required
  - `allow` VisaRequirement[], required
  - `total` integer, required
  - `excluded` object
    - `requirement_not_allowed` integer
    - `incomplete_data` integer
  - `destinations` GroupDestination[], required
    - `destination` string — ISO 3166-1 alpha-3 country code.
    - `group_requirement` 'visa_free' | 'visa_required' | 'e_visa' | 'visa_on_arrival' | 'eta' | 'no_admission'
    - `group_visa_free_days` integer, nullable — Minimum allowed stay across the whole group — the binding constraint.
    - `by_passport` object — Per-passport breakdown, keyed by ISO3.

## Other responses

- `400` — Missing or malformed parameter.
- `401` — Missing API key, query param or session cookie.
- `403` — Invalid / inactive key, or plan below the endpoint's minimum tier.
- `404` — No data for the requested resource.
- `429` — Monthly quota or burst rate exceeded.

---

[API](https://skmtc.net/orizn/apis/orizn-visa-api.md) · [All operations](https://skmtc.net/orizn/apis/orizn-visa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/orizn/orizn-visa-api/revisions/97ea5156ef11/schema)