# BRAINIAC Maritime Intelligence — Vessel Route Deviation Detector

> BRAINIAC Maritime Intelligence — Vessel Route Deviation Detector is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-14).

Analyzes AIS position data against planned routes/waypoints to detect and quantify vessel route deviations, flagging diversions with distance-from-route calculations.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/maritime-intelligence/vessel-route-deviation-detect?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-maritime-intelligence-vessel-route-deviation-detector-c9cf9599
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KdlmPKyq9uXmgxf-vGw-G

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 brainiac-maritime-intelligence-vessel-route-deviation-detector-c9cf9599 -d '<json body>'
```

Example prompt: I need to check whether the vessel MV Atlantic Pioneer (MMSI 123456789) deviated from its planned route between Singapore and Rotterdam — here's the AIS track data as a CSV and the waypoints JSON. Use a 50 km deviation threshold and flag anything outside that.

## When to prefer this

Use this endpoint when you have caller-supplied AIS position data and planned route waypoints and need to computationally detect route deviations without requiring a paid AIS subscription or API key. Ideal for compliance workflows, insurance verification, sanctions screening support, or logistics auditing where you already have the AIS export and voyage plan. Not suitable when you need real-time global AIS coverage or automated AIS data fetching — this endpoint analyzes only the data you provide.

## Known failure modes

- Missing or malformed AIS point data — no deviation can be computed without positions
- Missing waypoints or route data — route comparison impossible without reference path
- AIS points outside valid lat/lon range — schema validation failure
- Exceeding maxItems limits (500 vessels, 20 files) — request rejected
- No real-time AIS coverage — only caller-supplied data is analyzed, so incomplete tracks yield incomplete results
- Ambiguous vessel identity — MMSI/IMO mismatch may cause vessel grouping errors

## How this service works

Pay-per-call APIs for AI agents: OFAC sanctions screening, compliance checks, token security, and Base chain data via x402. No account. Fixed USDC price. MCP-ready.

## Output

Returns a JSON object with: a list of AIS points flagged as diversions (with lat/lon, timestamp, vessel key, distance from route in km, and threshold used), an overall status ('detected' or similar), structured findings with codes and details, counts of checked points and diversions, whether OFAC data was fetched, whether paid AIS was used, and a limitations list clarifying data sourcing and coverage constraints.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "asOf": {
   "type": "string",
   "maxLength": 40
  },
  "file": {
   "type": "object",
   "required": [
    "fileBase64"
   ],
   "properties": {
    "role": {
     "type": "string",
     "maxLength": 80
    },
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json",
      "application/octet-stream"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "files": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "fileBase64"
    ],
    "properties": {
     "role": {
      "type": "string",
      "maxLength": 80
     },
     "filename": {
      "type": "string",
      "maxLength": 180,
      "minLength": 1
     },
     "mediaType": {
      "enum": [
       "text/plain",
       "text/csv",
       "application/json",
       "application/octet-stream"
      ],
      "type": "string"
     },
     "fileBase64": {
      "type": "string",
      "maxLength": 12000000,
      "minLength": 1
     }
    },
    "additionalProperties": false
   },
   "maxItems": 20
  },
  "vessels": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "imo": {
      "type": "string",
      "maxLength": 20
     },
     "flag": {
      "type": "string",
      "maxLength": 80
     },
     "mmsi": {
      "type": "string",
      "maxLength": 20
     },
     "name": {
      "type": "string",
      "maxLength": 200
     },
     "owner": {
      "type": "string",
      "maxLength": 200
     },
     "source": {
      "type": "string",
      "maxLength": 200
     },
     "callSign": {
      "type": "string",
      "maxLength": 40
     },
     "operator": {
      "type": "string",
      "maxLength": 200
     },
     "vesselType": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 500
  },
  "aisPoints": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "at": "2026-11-02T00:00:00.000Z",
    "lat": 5,
    "lon": 108,
    "aisId": "A4",
    "source": "Caller-supplied AIS export",
    "diverted": true,
    "vesselKey": "V1",
    "paidAisUsed": false,
    "thresholdKm": 50,
    "distanceFromRouteKm": 174.2233
   }
  ],
  "status": "detected",
  "findings": [
   {
    "code": "route_deviation",
    "kind": "conflict",
    "detail": "AIS point is 174.2233 km from the planned route (threshold 50 km).",
    "subject": "A4"
   }
  ],
  "checkedAt": "2026-11-04T21:00:00.000Z",
  "pointCount": 2,
  "limitations": [
   "Vessel identities, AIS points, waypoints, port samples, demurrage cases, sanctions entries, cargo events, and ownership records are copied only from labeled fields supplied by the caller, or from the key-free public OFAC SDN publication when fetchOfac is requested.",
   "No paid AIS service is used and no API key is required. Global real-time vessel coverage is not claimed.",
   "Track gaps, route deviations, and ETA values use only supplied positions/speeds and simple geodesic math. Missing values are not invented.",
   "Sanctions signals are name/IMO comparisons only. Exact matches are labeled as signals, not confirmed legal determinations. Possible matches require human review.",
   "Demurrage amounts use only caller-supplied laytime and rate inputs and are not legal invoices."
  ],
  "ofacFetched": false,
  "paidAisUsed": false,
  "apiKeyRequired": false,
  "diversionCount": 1,
  "paidProviderUsed": false,
  "globalRealtimeCoverageClaimed": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-maritime-intelligence-vessel-route-deviation-detector-c9cf9599/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from www.brainiac.software](https://www.zero.xyz/host/www.brainiac.software/llms.txt)
