Practical travel information for a destination, including power requirements, emergency contacts, phone code, driving conventions, and typical climate.
Standards Used
- ISO 3166-1
- ISO 3166-2
- IEC 60083
The TravelInfo object#
| Field | Type | Required | Description |
|---|---|---|---|
| climate | null | object | No | |
| destination | string | Yes | Resolved location code (alpha-2 or ISO 3166-2 region code). Example: JP |
| driving_side | string | Yes | Driving side: "left" or "right". Example: left |
| emergency | object | Yes | Emergency contact numbers for a destination. |
| ambulance | string | Yes | Ambulance emergency number. Example: 911 |
| fire | string | Yes | Fire emergency number. Example: 911 |
| police | string | Yes | Police emergency number. Example: 911 |
| phone_code | string | Yes | International dialing code. Example: +81 |
| power | object | Yes | Power information for a destination. |
| frequency | integer (int32) | Yes | Standard frequency in hertz. Example: 60 |
| plugs | string[] | Yes | Plug types used in the destination (e.g., ["A", "B"]). Example: ["A","B"] |
| voltage | integer (int32) | Yes | Standard voltage. Example: 120 |
| power_compatibility | null | object | No |
PowerInfo#
| Field | Type | Required | Description |
|---|---|---|---|
| frequency | integer (int32) | Yes | Standard frequency in hertz. Example: 60 |
| plugs | string[] | Yes | Plug types used in the destination (e.g., ["A", "B"]). Example: ["A","B"] |
| voltage | integer (int32) | Yes | Standard voltage. Example: 120 |
PowerCompatibility#
| Field | Type | Required | Description |
|---|---|---|---|
| adapter_needed | boolean | Yes | Whether a plug adapter is needed. Example: true |
| shared_plugs | string[] | Yes | Plug types common to both origin and destination. Example: [] |
| voltage_compatible | boolean | Yes | Whether voltage is within safe range for devices from origin. Example: false |
EmergencyNumbers#
| Field | Type | Required | Description |
|---|---|---|---|
| ambulance | string | Yes | Ambulance emergency number. Example: 911 |
| fire | string | Yes | Fire emergency number. Example: 911 |
| police | string | Yes | Police emergency number. Example: 911 |
Climate#
| Field | Type | Required | Description |
|---|---|---|---|
| cloud_cover_percent | number (float) | Yes | Average cloud cover percentage. Example: 35.0 |
| humidity_percent | number (float) | Yes | Average relative humidity percentage. Example: 65.0 |
| month | string | Yes | Month name. Example: July |
| precipitation_hours | number (float) | Yes | Average precipitation hours per day. Example: 2.5 |
| precipitation_mm | number (float) | Yes | Average precipitation in millimeters. Example: 45.0 |
| sunshine_hours | number (float) | Yes | Average sunshine hours per day. Example: 9.5 |
| temp_high_c | number (float) | Yes | Average high temperature in Celsius. Example: 28.5 |
| temp_low_c | number (float) | Yes | Average low temperature in Celsius. Example: 18.2 |
| wind_speed_kmh | number (float) | Yes | Average wind speed in km/h. Example: 12.0 |
Endpoints#
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| destinationpath | string | Yes | Country code (alpha-2) or region code Example: JP |
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| fromquery | string | No | Origin country or region code for power compatibility comparison. Example: US |
| datequery | string | No | Travel date in YYYY-MM-DD format for climate data. Example: 2025-07-15 |
Response
| Field | Type | Required | Description |
|---|---|---|---|
| climate | null | object | No | |
| destination | string | Yes | Resolved location code (alpha-2 or ISO 3166-2 region code). Example: JP |
| driving_side | string | Yes | Driving side: "left" or "right". Example: left |
| emergency | object | Yes | Emergency contact numbers for a destination. |
| ambulance | string | Yes | Ambulance emergency number. Example: 911 |
| fire | string | Yes | Fire emergency number. Example: 911 |
| police | string | Yes | Police emergency number. Example: 911 |
| phone_code | string | Yes | International dialing code. Example: +81 |
| power | object | Yes | Power information for a destination. |
| frequency | integer (int32) | Yes | Standard frequency in hertz. Example: 60 |
| plugs | string[] | Yes | Plug types used in the destination (e.g., ["A", "B"]). Example: ["A","B"] |
| voltage | integer (int32) | Yes | Standard voltage. Example: 120 |
| power_compatibility | null | object | No |
Example Request
const response = await fetch(
'https://worlddataapi.com/v1/travel/JP?from=US&date=2025-07-15',
{
headers: {
'X-API-Key': 'YOUR_API_KEY'
}
}
);
const data = await response.json();import requests
response = requests.get(
'https://worlddataapi.com/v1/travel/JP',
params={
'from': 'example',
'date': '2024-06-21'
},
headers={
'X-API-Key': 'YOUR_API_KEY'
}
)
data = response.json()curl "https://worlddataapi.com/v1/travel/JP?from=US&date=2025-07-15"
-H "X-API-Key: YOUR_API_KEY"Error Responses
| Status | Description |
|---|---|
| 400 | Invalid parameters |
| 402 | Premium subscription required |
| 404 | Destination not found |
| 429 | Rate limit exceeded |