🏙️ Get City by IATA Code

Retrieve detailed information for a specific city by its IATA code

Returns comprehensive city information including name, country, timezone, and coordinates. The city must be active in the database.

Path Parameters

• iataCode (required): IATA 3-letter city code (e.g., “DXB”, “NYC”, “LON”)

Response

Returns a city object with:

• id: UUID primary key
• iata: IATA 3-letter code
• name: Full city name
• country: Country name
• country_code: ISO country code (2 letters)
• timezone: IANA timezone identifier
• latitude: City latitude
• longitude: City longitude
• active: Active status
• created_at: Creation timestamp
• updated_at: Last update timestamp

Example

GET /cities/DXB returns Dubai city information

Error Responses

• 404: City not found
• 503: Database table doesn’t exist (run migrations)