{"uid":"cap_KdlmPKyq9uXmgxf-vGw-G","slug":"brainiac-maritime-intelligence-vessel-route-deviation-detector-c9cf9599","name":"BRAINIAC Maritime Intelligence — Vessel Route Deviation Detector","description":"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.","url":"https://www.brainiac.software/api/v1/maritime-intelligence/vessel-route-deviation-detect?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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},"id":{"type":"string","maxLength":80},"imo":{"type":"string","maxLength":20},"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"mmsi":{"type":"string","maxLength":20},"sogKn":{"type":"number","maximum":100,"minimum":0},"cogDeg":{"type":"number","maximum":360,"minimum":0},"source":{"type":"string","maxLength":200},"vesselId":{"type":"string","maxLength":80},"navStatus":{"type":"string","maxLength":80},"headingDeg":{"type":"number","maximum":360,"minimum":0}},"additionalProperties":false},"maxItems":10000},"fetchOfac":{"type":"boolean"},"waypoints":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"name":{"type":"string","maxLength":120},"source":{"type":"string","maxLength":200},"sequence":{"type":"integer","maximum":10000,"minimum":0},"vesselId":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"cargoEvents":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"side":{"enum":["document","ops","left","right","a","b"],"type":"string"},"unit":{"type":"string","maxLength":40},"source":{"type":"string","maxLength":200},"location":{"type":"string","maxLength":160},"quantity":{"type":"number","maximum":1000000000,"minimum":0},"vesselId":{"type":"string","maxLength":80},"eventType":{"type":"string","maxLength":80},"shipmentId":{"type":"string","maxLength":80},"billOfLading":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":5000},"portSamples":{"type":"array","items":{"type":"object","properties":{"at":{"type":"string","maxLength":40},"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"portCode":{"type":"string","maxLength":20},"portName":{"type":"string","maxLength":160},"arrivals24h":{"type":"number","maximum":100000,"minimum":0},"departures24h":{"type":"number","maximum":100000,"minimum":0},"vesselsWaiting":{"type":"number","maximum":100000,"minimum":0},"averageWaitHours":{"type":"number","maximum":10000,"minimum":0},"berthOccupancyPct":{"type":"number","maximum":100,"minimum":0}},"additionalProperties":false},"maxItems":2000},"assumedSpeedKn":{"type":"number","maximum":50,"minimum":0.1},"demurrageCases":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"source":{"type":"string","maxLength":200},"endedAt":{"type":"string","maxLength":40},"currency":{"type":"string","maxLength":12},"vesselId":{"type":"string","maxLength":80},"voyageId":{"type":"string","maxLength":80},"startedAt":{"type":"string","maxLength":40},"laytimeUsedHours":{"type":"number","maximum":100000,"minimum":0},"demurrageRatePerDay":{"type":"number","maximum":100000000,"minimum":0},"laytimeAllowedHours":{"type":"number","maximum":100000,"minimum":0}},"additionalProperties":false},"maxItems":500},"destinationLat":{"type":"number","maximum":90,"minimum":-90},"destinationLon":{"type":"number","maximum":180,"minimum":-180},"ownershipRecords":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"to":{"type":"string","maxLength":40},"imo":{"type":"string","maxLength":20},"flag":{"type":"string","maxLength":80},"from":{"type":"string","maxLength":40},"owner":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"vesselId":{"type":"string","maxLength":80},"ownerType":{"type":"string","maxLength":80}},"additionalProperties":false},"maxItems":2000},"sanctionsEntries":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"imo":{"type":"string","maxLength":20},"name":{"type":"string","maxLength":200},"source":{"type":"string","maxLength":200},"program":{"type":"string","maxLength":120},"sourceUrl":{"type":"string","maxLength":400}},"additionalProperties":false},"maxItems":2000},"gapThresholdHours":{"type":"number","maximum":720,"minimum":0.1},"deviationThresholdKm":{"type":"number","maximum":5000,"minimum":0.1}}},"responseSchema":{"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}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lBYP7XhmNaDdTBdmwCUZk","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes AIS position data against planned routes/waypoints to detect and quantify vessel route deviations, flagging diversions with distance-from-route calculations.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Cargo ship off-course compliance check","prompt":"We have AIS data for a bulk carrier (IMO 9876543) that was supposed to sail from Dubai to Djibouti. Here's the CSV of its position history and the planned waypoints. Can you check if it deviated more than 30 km from the declared route at any point?"},{"title":"Sanctions evasion route anomaly detection","prompt":"I'm reviewing a tanker that was flagged for potential sanctions evasion — MMSI 987654321, name 'Sea Phantom'. I have its AIS points from the past week and its filed voyage plan. Run a route deviation check with a 50 km threshold and tell me where it went off course."},{"title":"Insurance claim route verification","prompt":"An insurer needs to verify whether the container vessel 'Nordic Star' (IMO 1234567) actually followed the route it declared for its insurance policy. Here's the AIS export and the planned waypoints. Flag any deviations greater than 25 km."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T06:33:19.480Z","isFirstParty":false,"canonicalSlug":"brainiac-maritime-intelligence-vessel-route-deviation-detector-c9cf9599"}