> ## Documentation Index > Fetch the complete documentation index at: https://mintlify.com/koala73/worldmonitor/llms.txt > Use this file to discover all available pages before exploring further. # MilitaryService > Military flight tracking, bases, and theater posture intelligence The MilitaryService provides APIs for tracking military aircraft from OpenSky and Wingbits, retrieving military base data, accessing USNI Fleet intelligence reports, and assessing theater-level military posture. ## Base Path ``` /api/military/v1 ``` ## ListMilitaryFlights Retrieves tracked military aircraft from OpenSky and Wingbits within a geographic bounding box, with optional filtering by operator and aircraft type. **Endpoint:** `GET /api/military/v1/list-military-flights` ### Request Parameters Maximum items per page (1-100) Cursor for next page North-east corner latitude of bounding box North-east corner longitude of bounding box South-west corner latitude of bounding box South-west corner longitude of bounding box Optional operator filter (e.g., `MILITARY_OPERATOR_USAF`, `MILITARY_OPERATOR_RAF`) Optional aircraft type filter (e.g., `MILITARY_AIRCRAFT_TYPE_FIGHTER`, `MILITARY_AIRCRAFT_TYPE_TANKER`) ### Response Individual military flights Unique flight identifier Aircraft callsign ICAO 24-bit hex address Aircraft registration number Type of military aircraft (FIGHTER, BOMBER, TRANSPORT, TANKER, AWACS, etc.) Specific aircraft model (e.g., "F-35A", "C-17A") Operating military branch or force Country operating the aircraft (ISO 3166-1 alpha-2) Current position Altitude in feet Heading in degrees Speed in knots Vertical rate in feet per minute Whether the aircraft is on the ground Transponder squawk code ICAO code of the origin airport ICAO code of the destination airport Last seen time, as Unix epoch milliseconds First seen time, as Unix epoch milliseconds Confidence in aircraft identification (LOW, MEDIUM, HIGH) Whether flagged for unusual activity Analyst note Wingbits enrichment data (manufacturer, owner, operator details) Geographic clusters of flights Unique cluster identifier Descriptive name of the cluster Cluster centroid location Number of flights in the cluster The flights in this cluster Dominant operator in the cluster Assessed activity type (EXERCISE, PATROL, TRANSPORT, DEPLOYMENT, etc.) Pagination metadata ### Example Request ```bash theme={null} curl "https://your-domain.com/api/military/v1/list-military-flights?ne_lat=55.0&ne_lon=15.0&sw_lat=45.0&sw_lon=5.0&operator=MILITARY_OPERATOR_USAF&page_size=50" ``` *** ## GetTheaterPosture Retrieves military posture assessments for geographic theaters, providing strategic-level situational awareness. **Endpoint:** `GET /api/military/v1/get-theater-posture` ### Request Parameters Theater name (e.g., "indo-pacific", "european", "middle-east"). Empty returns all theaters. ### Response Theater posture assessments (one per theater, or all if no filter) Theater-level military posture and activity assessment ### Example Request ```bash theme={null} curl "https://your-domain.com/api/military/v1/get-theater-posture?theater=indo-pacific" ``` *** ## GetAircraftDetails Retrieves Wingbits aircraft enrichment data for a single ICAO24 hex, providing detailed aircraft information. **Endpoint:** `GET /api/military/v1/get-aircraft-details` ### Request Parameters ICAO 24-bit hex address (lowercase) ### Response Aircraft details, absent if not found ICAO 24-bit hex address Aircraft registration number ICAO manufacturer code Full manufacturer name Aircraft model ICAO type designator code Manufacturer serial number ICAO aircraft type designator Operator name Operator callsign Operator ICAO code Registered owner Build date Engine description ICAO category description Whether the Wingbits API is configured ### Example Request ```bash theme={null} curl "https://your-domain.com/api/military/v1/get-aircraft-details?icao24=ae01ce" ``` *** ## GetAircraftDetailsBatch Retrieves Wingbits aircraft enrichment data for multiple ICAO24 hexes in a single request. **Endpoint:** `POST /api/military/v1/get-aircraft-details-batch` ### Request Body Array of ICAO 24-bit hex addresses (lowercase) ### Response Map of ICAO24 hex to aircraft details Whether the Wingbits API is configured ### Example Request ```bash theme={null} curl -X POST "https://your-domain.com/api/military/v1/get-aircraft-details-batch" \ -H "Content-Type: application/json" \ -d '{"icao24s": ["ae01ce", "ae04e2", "ae0443"]}' ``` *** ## GetWingbitsStatus Checks whether the Wingbits enrichment API is configured and available. **Endpoint:** `GET /api/military/v1/get-wingbits-status` ### Request Parameters No parameters required. ### Response Whether the Wingbits API is configured with valid credentials Status message ### Example Request ```bash theme={null} curl "https://your-domain.com/api/military/v1/get-wingbits-status" ``` *** ## GetUSNIFleetReport Retrieves the latest parsed USNI Fleet Tracker report with information about U.S. Navy carrier strike groups and deployments. **Endpoint:** `GET /api/military/v1/get-usni-fleet-report` ### Request Parameters When true, bypass cache and fetch fresh data from USNI ### Response The parsed fleet report, if available Whether the response was served from cache Whether the cached data is stale (served after a fetch failure) Error message, if any ### Example Request ```bash theme={null} curl "https://your-domain.com/api/military/v1/get-usni-fleet-report?force_refresh=true" ``` *** ## ListMilitaryBases Retrieves military bases within a bounding box with server-side clustering for map visualization. **Endpoint:** `GET /api/military/v1/list-military-bases` ### Request Parameters North-east corner latitude of bounding box North-east corner longitude of bounding box South-west corner latitude of bounding box South-west corner longitude of bounding box Map zoom level for clustering threshold Optional base type filter Optional base kind filter Optional country filter (ISO 3166-1 alpha-2) ### Response Individual military bases in the view Unique base identifier Base name Base latitude Base longitude Base kind (e.g., "air\_base", "naval\_base") Country code (ISO 3166-1 alpha-2) Base type Base tier or classification level Whether base has air force capabilities Whether base has naval capabilities Whether base has nuclear capabilities Whether base has space capabilities Whether base is primarily for training Military branch Operational status Geographic clusters of bases Cluster centroid latitude Cluster centroid longitude Number of bases in cluster Most common base type in cluster Zoom level at which cluster expands Total bases in the bounding box Whether results were truncated ### Example Request ```bash theme={null} curl "https://your-domain.com/api/military/v1/list-military-bases?ne_lat=50.0&ne_lon=10.0&sw_lat=40.0&sw_lon=0.0&zoom=6" ```