{"uid":"cap_JhR4P4fU-Cv6Gx0kyaglP","slug":"brainiac-maritime-intelligence-cargo-shipment-event-reconcile-f8304340","name":"BRAINIAC Maritime Intelligence — Cargo Shipment Event Reconcile","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/cargo-shipment-event-reconcile?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":[{"key":"sh1|loaded|2026-11-01|sgsin","opsAt":"2026-11-01","source":"Caller-supplied; Caller-supplied","eventType":"loaded","documentAt":"2026-11-01","opsEventId":"C2","reconciled":true,"shipmentId":"SH1","billOfLading":"BL1","quantityMatch":true,"documentEventId":"C1"}],"status":"reconciled","findings":[],"checkedAt":"2026-11-04T21:00:00.000Z","eventCount":1,"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,"reconciledCount":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_VlmqxeM3vHbLqrWURWNOH","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":"Reconciles cargo shipment events against operational AIS data, documents, and compliance signals to identify discrepancies, sanctions matches, and demurrage findings","exampleAgentPrompt":"I need to reconcile shipment SH1 with bill of lading BL1 — the cargo was loaded at Singapore on 2026-11-01. Cross-check the event against the AIS positions I'm supplying for vessel IMO 9123456 and flag any quantity mismatches or OFAC sanctions signals.","exampleUseCases":[{"title":"Trade finance cargo event audit","prompt":"We have a bill of lading BL-2024-887 for a container shipment loaded at Rotterdam on 2024-09-15 aboard vessel IMO 9876543. Can you reconcile the loading and discharge events against the AIS points I'm providing and tell me if the quantities match and if there are any findings?"},{"title":"Sanctions compliance check on a vessel shipment","prompt":"I need to check whether the vessels involved in shipment SH-442 — MMSI 338234510 and IMO 9345678 — have any OFAC sanctions signals. Please fetch the OFAC SDN list and reconcile against the cargo events in the JSON I'm attaching, as of today."},{"title":"Demurrage dispute evidence gathering","prompt":"We're disputing demurrage on shipment ID CARGO-991. I have the laytime data, AIS position history, and cargo event log as a CSV. Can you reconcile the events to see if the vessel arrival and departure times match the documented cargo operations, and identify any discrepancies?"}],"resultDescription":"Returns a JSON object with an array of reconciled event items (each with event type, shipment ID, bill of lading, quantity match flag, and reconciliation status), overall reconciliation status, a list of findings or anomalies, counts of reconciled events, flags indicating whether OFAC data or paid AIS was used, and a detailed limitations section clarifying data provenance and coverage.","failureModes":["Missing required cargo event data results in empty items array with unreconciled status","Vessel IMO/MMSI not supplied means sanctions and AIS matching cannot be performed","AIS points with gaps produce track-gap findings rather than confirmed positions","Quantity mismatches flagged as findings but not auto-resolved","OFAC fetch may be unavailable or return stale data; fetchOfac must be explicitly requested","Input CSV/JSON exceeding 200,000 characters will be rejected","Sanctions signals are name/IMO comparisons only and are not legal determinations"],"whenToPreferThis":"Use this endpoint when you need to reconcile cargo shipment documentary events (bills of lading, loading/discharge records) against vessel AIS position data and want integrated OFAC sanctions screening — all without needing a paid AIS subscription or API key. Prefer this over manual document review or siloed compliance tools when you have structured shipment event data and want a single-call audit trail with explicit data provenance limitations disclosed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-14T06:34:01.432Z","isFirstParty":false,"canonicalSlug":"brainiac-maritime-intelligence-cargo-shipment-event-reconcile-f8304340"}