latestOpenAPI 3.1.02026-08-21211181.8 KB

e5d7af502419

Countries

Visa-free destinations for a passport

Where a passport can travel without a visa, as one complete list (the API walks the upstream's pages). An inspiration list, not a visa rule: it carries no visa type and no permitted stay, and a country's absence means absent from Wego's list, never that a visa is required.

get/v1/countries/{countryCode}/visa-free-destinations

Path parameters

countryCodestring required
Example:AE

ISO 3166-1 alpha-2 code of the PASSPORT whose visa-free destinations you want (e.g. AE). A passport, not a market: any well-formed code is accepted (a passport need not be a Wego market) and an unrecognized one returns an honest empty list. The same path segment means a market on the holidays route.

Query parameters

localestring

Locale for localized names (e.g. en, ar). Defaults to en.

pageinteger

Page number, 1-based (max 20). Defaults to 1. The list is a bounded registry the API assembles whole, so paging is rarely needed and the cap is low by design.

pageSizeinteger

Rows per page (1-200). Defaults to 200, which is also the maximum: this is a bounded registry the API walks completely, so the default returns the whole list. pageSize exists only to narrow a long answer, never to force paging.

Response

Visa-free destinations for this passport, keyed on countryCode for joining.