MilitaryService

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

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

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

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"

Overview

Services

Data Sources

Base Path

ListMilitaryFlights

Request Parameters

Response

Example Request

GetTheaterPosture

Request Parameters

Response

Example Request

GetAircraftDetails

Request Parameters

Response

Example Request

GetAircraftDetailsBatch

Request Body

Response

Example Request

GetWingbitsStatus

Request Parameters

Response

Example Request

GetUSNIFleetReport

Request Parameters

Response

Example Request

ListMilitaryBases

Request Parameters

Response

Example Request

Build docs developers (and LLMs) love

Overview

Services

Data Sources

​Base Path

​ListMilitaryFlights

​Request Parameters

​Response

​Example Request

​GetTheaterPosture

​Request Parameters

​Response

​Example Request

​GetAircraftDetails

​Request Parameters

​Response

​Example Request

​GetAircraftDetailsBatch

​Request Body

​Response

​Example Request

​GetWingbitsStatus

​Request Parameters

​Response

​Example Request

​GetUSNIFleetReport

​Request Parameters

​Response

​Example Request

​ListMilitaryBases

​Request Parameters

​Response

​Example Request

Build docs developers (and LLMs) love

Base Path

ListMilitaryFlights

Request Parameters

Response

Example Request

GetTheaterPosture

Request Parameters

Response

Example Request

GetAircraftDetails

Request Parameters

Response

Example Request

GetAircraftDetailsBatch

Request Body

Response

Example Request

GetWingbitsStatus

Request Parameters

Response

Example Request

GetUSNIFleetReport

Request Parameters

Response

Example Request

ListMilitaryBases

Request Parameters

Response

Example Request