# War-Tracker Vessel Search API

> War-Tracker Vessel Search API is a paid API for AI agents from war-tracker.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Searches a database of vessels by various criteria, returning ship details including sanction status, watchlist flags, and last-seen location timestamps.

## Facts

- Endpoint: GET https://war-tracker.com/api/v1/vessels/search
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/war-tracker-vessel-search-api-a6887627
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7NIxHH4sJSI7tpluv3w0b

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability war-tracker-vessel-search-api-a6887627
```

Example prompt: Can you search for sanctioned crude oil tankers flagged in the Marshall Islands using the War-Tracker vessel database?

## When to prefer this

Choose this endpoint when you need to search or screen vessels by name, IMO, MMSI, type, sanction status, or watchlist flag — particularly for maritime compliance, investigative OSINT, or shadow fleet research. Prefer it over general AIS trackers when sanctions and watchlist enrichment are required alongside basic vessel identification.

## Known failure modes

- No vessels match the search criteria — returns count 0 and empty vessels array
- Invalid or malformed IMO/MMSI number — may return empty results or validation error
- Rate limit or payment failure — request rejected due to insufficient USDC balance
- Pagination cursor expired or malformed — returns error or resets to first page
- Unknown ship type or subtype filter value — may return empty results

## How this service works

War-Tracker is a live war tracker map showing real-time military strikes and conflict events worldwide. Unbiased, uncensored OSINT: track Ukraine, Middle East, and global conflicts with video evidence as they happen.

## Output

Returns a paginated JSON object containing a count of matching vessels, an array of vessel records (each with IMO, MMSI, name, type, subtype, length, year built, country code, sanction status, watchlist status, last seen UTC timestamp, and commercial market name), a has_more boolean, and a next_cursor string for fetching additional pages.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "vessels": [
   {
    "imo": 9368223,
    "mmsi": 538003228,
    "name": "ACHILLES",
    "type": "Tanker",
    "length": 333,
    "ship_id": "10330187",
    "subtype": "Crude Oil Tanker",
    "sanctioned": true,
    "year_built": 2007,
    "watchlisted": true,
    "country_code": "MH",
    "last_seen_utc": "2026-05-17T11:42:00Z",
    "commercial_market_name": "WET BULK"
   }
  ],
  "has_more": true,
  "next_cursor": "eyJsYXN0X3NlZW4iOiIyMDI2LTA1LTE3VDExOjQyOjAwWiIsInNoaXBfaWQiOiIxMDMzMDE4NyJ9"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/war-tracker-vessel-search-api-a6887627/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from war-tracker.com](https://www.zero.xyz/host/war-tracker.com/llms.txt)
