Eammu API Documentation

The Eammu Travel API provides real-time access to visa requirements, country data, embassy locations, and airport information. Built for travel apps, visa consultancies, and developers worldwide.

BASE URL
https://api.eammu.com

Authentication

All API requests require an API key. Pass it as a header or query parameter.

Header (Recommended)
-H "x-api-key: eak_your_key"
Query Parameter
?api_key=eak_your_key
GET/api/v1/passport

Get visa requirements for a passport holder traveling to any country.

PARAMETERS
fromrequiredPassport country name. Example: Bangladesh
tooptionalDestination country. If omitted, returns all destinations.
api_keyrequiredYour API key (or use x-api-key header)
REQUEST
curl "https://api.eammu.com/api/v1/passport?from=Bangladesh&to=Japan" \
  -H "x-api-key: eak_your_key"
RESPONSE
{
  "from": {
    "name": "Bangladesh",
    "flag": "https://twemoji.../1f1e7-1f1e9.svg",
    "code": "bd"
  },
  "to": {
    "name": "Japan",
    "flag": "https://twemoji.../1f1ef-1f1f5.svg",
    "code": "jp"
  },
  "visa_status": "visa required"
}
GET/api/v1/countries

Get country list with flags and ISO codes.

PARAMETERS
nameoptionalFilter by country name (partial match)
codeoptionalFilter by ISO 2-letter code. Example: bd
api_keyrequiredYour API key
REQUEST
curl "https://api.eammu.com/api/v1/countries?name=Bangladesh" \
  -H "x-api-key: eak_your_key"
RESPONSE
{
  "total": 1,
  "countries": [
    {
      "country": "Bangladesh",
      "flag": "https://twemoji.../1f1e7-1f1e9.svg",
      "code": "bd"
    }
  ]
}
GET/api/v1/embassies

Find embassy and consulate locations worldwide.

PARAMETERS
operatoroptionalEmbassy's home country. Example: Bangladesh
countryoptionalCountry where embassy is located
cityoptionalCity filter
api_keyrequiredYour API key
REQUEST
curl "https://api.eammu.com/api/v1/embassies?operator=Bangladesh&country=Japan" \
  -H "x-api-key: eak_your_key"
RESPONSE
{
  "total": 1,
  "embassies": [
    {
      "operator": "Bangladesh",
      "country": "Japan",
      "city": "Tokyo",
      "type": "embassy",
      "website": "https://...",
      "latitude": 35.6762,
      "longitude": 139.6503
    }
  ]
}
GET/api/v1/airports

Search airport data including IATA codes, coordinates, and routes.

PARAMETERS
countryoptionalFilter by country name
cityoptionalFilter by city
codeoptionalIATA airport code. Example: DAC
api_keyrequiredYour API key
REQUEST
curl "https://api.eammu.com/api/v1/airports?code=DAC" \
  -H "x-api-key: eak_your_key"
RESPONSE
{
  "total": 1,
  "airports": [
    {
      "code": "DAC",
      "name": "Hazrat Shahjalal International Airport",
      "city": "Dhaka",
      "country": "Bangladesh",
      "lat": "23.8433",
      "lon": "90.3978",
      "direct_flights": "37"
    }
  ]
}

Error Codes

400Bad RequestMissing required parameter (e.g. ?from=)
401UnauthorizedMissing or invalid API key
403ForbiddenAccount suspended
404Not FoundCountry or resource not found
429Too Many RequestsDaily or monthly limit reached
500Server ErrorInternal error — contact support

Visa Status Values

visa requiredMust apply for visa in advance
e-visaApply online before travel
visa on arrivalGet visa at the border
etaElectronic travel authorization required
no admissionEntry not permitted
number (e.g. 90)Visa-free days allowed