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

page_size · int32

Maximum items per page (1-100)

cursor · string

Cursor for next page

ne_lat · double

North-east corner latitude of bounding box

ne_lon · double

North-east corner longitude of bounding box

sw_lat · double

South-west corner latitude of bounding box

sw_lon · double

South-west corner longitude of bounding box

operator · MilitaryOperator

Optional operator filter (e.g., MILITARY_OPERATOR_USAF, MILITARY_OPERATOR_RAF)

aircraft_type · MilitaryAircraftType

Optional aircraft type filter (e.g., MILITARY_AIRCRAFT_TYPE_FIGHTER, MILITARY_AIRCRAFT_TYPE_TANKER)

Response

flights · MilitaryFlight[]

Individual military flights

Show MilitaryFlight

id · string · required

Unique flight identifier

callsign · string

Aircraft callsign

hex_code · string

ICAO 24-bit hex address

registration · string

Aircraft registration number

aircraft_type · MilitaryAircraftType

Type of military aircraft (FIGHTER, BOMBER, TRANSPORT, TANKER, AWACS, etc.)

aircraft_model · string

Specific aircraft model (e.g., “F-35A”, “C-17A”)

operator · MilitaryOperator

Operating military branch or force

operator_country · string

Country operating the aircraft (ISO 3166-1 alpha-2)

location · GeoCoordinates

Current position

altitude · double

Altitude in feet

heading · double

Heading in degrees

speed · double

Speed in knots

vertical_rate · double

Vertical rate in feet per minute

on_ground · bool

Whether the aircraft is on the ground

squawk · string

Transponder squawk code

origin · string

ICAO code of the origin airport

destination · string

ICAO code of the destination airport

last_seen_at · int64

Last seen time, as Unix epoch milliseconds

first_seen_at · int64

First seen time, as Unix epoch milliseconds

confidence · MilitaryConfidence

Confidence in aircraft identification (LOW, MEDIUM, HIGH)

is_interesting · bool

Whether flagged for unusual activity

note · string

Analyst note

enrichment · FlightEnrichment

Wingbits enrichment data (manufacturer, owner, operator details)

clusters · MilitaryFlightCluster[]

Geographic clusters of flights

Show MilitaryFlightCluster

id · string

Unique cluster identifier

name · string

Descriptive name of the cluster

location · GeoCoordinates

Cluster centroid location

flight_count · int32

Number of flights in the cluster

flights · MilitaryFlight[]

The flights in this cluster

dominant_operator · MilitaryOperator

Dominant operator in the cluster

activity_type · MilitaryActivityType

Assessed activity type (EXERCISE, PATROL, TRANSPORT, DEPLOYMENT, etc.)

pagination · PaginationResponse

Pagination metadata

Example Request

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 · string

Theater name (e.g., “indo-pacific”, “european”, “middle-east”). Empty returns all theaters.

Response

theaters · TheaterPosture[]

Theater posture assessments (one per theater, or all if no filter)

Show TheaterPosture

Theater-level military posture and activity assessment

Example Request

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

icao24 · string · required

ICAO 24-bit hex address (lowercase)

Response

details · AircraftDetails

Aircraft details, absent if not found

Show AircraftDetails

icao24 · string

ICAO 24-bit hex address

registration · string

Aircraft registration number

manufacturer_icao · string

ICAO manufacturer code

manufacturer_name · string

Full manufacturer name

model · string

Aircraft model

typecode · string

ICAO type designator code

serial_number · string

Manufacturer serial number

icao_aircraft_type · string

ICAO aircraft type designator

operator · string

Operator name

operator_callsign · string

Operator callsign

operator_icao · string

Operator ICAO code

owner · string

Registered owner

built · string

Build date

engines · string

Engine description

category_description · string

ICAO category description

configured · bool

Whether the Wingbits API is configured

Example Request

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

icao24s · string[] · required

Array of ICAO 24-bit hex addresses (lowercase)

Response

details · map<string, AircraftDetails>

Map of ICAO24 hex to aircraft details

configured · bool

Whether the Wingbits API is configured

Example Request

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

configured · bool

Whether the Wingbits API is configured with valid credentials

status · string

Status message

Example Request

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

force_refresh · bool

When true, bypass cache and fetch fresh data from USNI

Response

report · USNIFleetReport

The parsed fleet report, if available

cached · bool

Whether the response was served from cache

stale · bool

Whether the cached data is stale (served after a fetch failure)

error · string

Error message, if any

Example Request

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

ne_lat · double

North-east corner latitude of bounding box

ne_lon · double

North-east corner longitude of bounding box

sw_lat · double

South-west corner latitude of bounding box

sw_lon · double

South-west corner longitude of bounding box

zoom · int32

Map zoom level for clustering threshold

type · string

Optional base type filter

kind · string

Optional base kind filter

country · string

Optional country filter (ISO 3166-1 alpha-2)

Response

bases · MilitaryBaseEntry[]

Individual military bases in the view

Show MilitaryBaseEntry

id · string

Unique base identifier

name · string

Base name

latitude · double

Base latitude

longitude · double

Base longitude

kind · string

Base kind (e.g., “air_base”, “naval_base”)

country_iso2 · string

Country code (ISO 3166-1 alpha-2)

type · string

Base type

tier · int32

Base tier or classification level

cat_airforce · bool

Whether base has air force capabilities

cat_naval · bool

Whether base has naval capabilities

cat_nuclear · bool

Whether base has nuclear capabilities

cat_space · bool

Whether base has space capabilities

cat_training · bool

Whether base is primarily for training

branch · string

Military branch

status · string

Operational status

clusters · MilitaryBaseCluster[]

Geographic clusters of bases

Show MilitaryBaseCluster

latitude · double

Cluster centroid latitude

longitude · double

Cluster centroid longitude

count · int32

Number of bases in cluster

dominant_type · string

Most common base type in cluster

expansion_zoom · int32

Zoom level at which cluster expands

total_in_view · int32

Total bases in the bounding box

truncated · bool

Whether results were truncated

Example Request

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"