The Aero API provides comprehensive access to real-time flight tracking, airport information, airline data, and flight booking management. Built with NestJS, the API offers a RESTful interface for integrating aviation data into your applications.
Base URL
All API requests should be made to:
The API uses versioned endpoints with a /v1 prefix. All production endpoints follow the pattern: http://localhost:3000/v1/{resource}
API versioning
The API uses URI-based versioning with version 1 as the default. All endpoints are prefixed with /v1.
Key features
The Aero API provides access to:
Authentication
Secure user registration and login with JWT tokens
Flight tracking
Real-time flight tracking with detailed position data and flight paths
Airport data
Access to over 20,000 airport records with search capabilities
Airline information
Comprehensive database of over 800 commercial airlines
Flight bookings
Create and manage flight bookings with complete CRUD operations
User profiles
Track and analyze personal flight statistics and travel history
Success response
{
"id": "user_abc123",
"name": "John Doe"
}
Error response
{
"message": "No user found with given email."
}
Status codes
The API uses standard HTTP status codes:
| Status Code | Description |
|---|
200 | Success - Request completed successfully |
201 | Created - Resource created successfully |
400 | Bad Request - Invalid request parameters |
401 | Unauthorized - Authentication required or failed |
404 | Not Found - Resource not found |
409 | Conflict - Resource already exists |
500 | Internal Server Error - Server error occurred |
Rate limiting
The API relies on third-party services including:
- Aviation Stack API - Flight data between airports
- AeroDataBox (RapidAPI) - Aviation data
- FlightAware API - Real-time flight tracking
Rate limits depend on your subscription tier with these third-party services. Configure your API keys in the environment variables to access these features.
Interactive documentation
The API includes interactive documentation powered by Scalar at:
http://localhost:3000/docs
Next steps
Set up authentication
Learn how to register users and authenticate API requests
Explore endpoints
Browse the available API endpoints in the reference documentation
Make your first request
Try querying airport or airline data