---
title: "GetUSNIFleetReport"
method: GET
path: "/api/military/v1/get-usni-fleet-report"
tags: ["MilitaryService"]
---

# GetUSNIFleetReport

`GET /api/military/v1/get-usni-fleet-report`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/military/v1/get-usni-fleet-report`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`

Retrieve the latest parsed USNI Fleet Tracker report, with article date, source link, fleet summary and cache status for understanding published naval activity.

## Query parameters

- `force_refresh` boolean
- `jmespath` string

## Response `200`

OK

- WorldmonitorMilitaryV1GetUSNIFleetReportResponse: GetUSNIFleetReportResponse returns the parsed USNI Fleet Tracker report.
  - `report` WorldmonitorMilitaryV1USNIFleetReport: USNIFleetReport is the full parsed output of a USNI Fleet Tracker article.
    - `articleUrl` string: URL of the source article.
    - `articleDate` string: Publication date of the article.
    - `articleTitle` string: Title of the article.
    - `battleForceSummary` WorldmonitorMilitaryV1BattleForceSummary: BattleForceSummary contains fleet-wide ship count statistics.
      - `totalShips` integer: Total ships in the battle force.
      - `deployed` integer: Number of ships currently deployed.
      - `underway` integer: Number of ships currently underway.
    - `vessels` WorldmonitorMilitaryV1USNIVessel[]
      - `name` string, required: Vessel name (e.g., "USS Abraham Lincoln").
      - `hullNumber` string, required: Hull designation (e.g., "CVN-72", "DDG-51").
      - `vesselType` string: Vessel type classification (e.g., "carrier", "destroyer", "submarine").
      - `region` string: Region name where the vessel is operating.
      - `regionLat` number, double: Approximate latitude for the region.
      - `regionLon` number, double: Approximate longitude for the region.
      - `deploymentStatus` string: Deployment status (e.g., "deployed", "underway", "in-port", "unknown").
      - `homePort` string: Home port, if identified from the article text.
      - `strikeGroup` string: Strike group assignment, if any.
      - `activityDescription` string: Brief activity description parsed from article prose.
      - `articleUrl` string: URL of the USNI article this vessel was parsed from.
      - `articleDate` string: Publication date of the USNI article.
    - `strikeGroups` WorldmonitorMilitaryV1USNIStrikeGroup[]
      - `name` string: Strike group name (e.g., "Abraham Lincoln Carrier Strike Group").
      - `carrier` string: Carrier name and hull (e.g., "USS Abraham Lincoln (CVN-72)").
      - `airWing` string: Assigned air wing (e.g., "Carrier Air Wing Nine").
      - `destroyerSquadron` string: Assigned destroyer squadron.
      - `escorts` string[]
    - `regions` string[]
    - `parsingWarnings` string[]
    - `timestamp` integer: Warning: Values > 2^53 may lose precision in JavaScript
  - `cached` boolean: Whether the response was served from cache.
  - `stale` boolean: Whether the cached data is stale (served after a fetch failure).
  - `error` string: Error message, if any.

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: API access requires an active subscription (the API key's subscription is inactive or expired).
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

[API](https://skmtc.dev/worldmonitor/apis/worldmonitor-api.md) · [All operations](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/llms.txt) · [OpenAPI document](https://skmtc.dev/worldmonitor/apis/worldmonitor-api/revisions/e3dc8463a5c9?raw)