{"uid":"cap_9aOmZayVyBtknizWDc9vb","slug":"brainiac-bill-of-lading-extract-consistency-check-211645fd","name":"BRAINIAC Bill of Lading Extract & Consistency Check","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/freight-customs/bill-of-lading-extract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"file":{"type":"object","required":["mediaType","fileBase64"],"properties":{"filename":{"type":"string","maxLength":180,"minLength":1},"mediaType":{"enum":["application/pdf","text/plain"],"type":"string"},"fileBase64":{"type":"string","maxLength":12000000,"minLength":1}},"additionalProperties":false},"text":{"type":"string","maxLength":200000,"minLength":1},"shipment":{"type":"object","properties":{"lines":{"type":"array","items":{"type":"object","required":["description"],"properties":{"unit":{"type":"string","maxLength":20,"minLength":1},"amount":{"type":"number","maximum":1000000000000,"minimum":0},"hsCode":{"type":"string","maxLength":14,"minLength":4},"packages":{"type":"integer","maximum":1000000,"minimum":0},"quantity":{"type":"number","maximum":1000000000,"exclusiveMinimum":0},"volumeM3":{"type":"number","maximum":1000000,"minimum":0},"unitPrice":{"type":"number","maximum":1000000000000,"minimum":0},"description":{"type":"string","maxLength":300,"minLength":1},"netWeightKg":{"type":"number","maximum":1000000000,"minimum":0},"grossWeightKg":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false},"maxItems":80},"vessel":{"type":"string","maxLength":120,"minLength":1},"voyage":{"type":"string","maxLength":40,"minLength":1},"parties":{"type":"array","items":{"type":"object","required":["role","name"],"properties":{"name":{"type":"string","maxLength":200,"minLength":1},"role":{"enum":["seller","exporter","buyer","importer","consignee","shipper","notify"],"type":"string"},"address":{"type":"string","maxLength":400,"minLength":1}},"additionalProperties":false},"maxItems":12},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"incoterm":{"type":"string","maxLength":80,"minLength":3},"reference":{"type":"string","maxLength":80,"minLength":1},"namedPlace":{"type":"string","maxLength":160,"minLength":1},"invoiceDate":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"totalAmount":{"type":"number","maximum":1000000000000,"minimum":0},"invoiceNumber":{"type":"string","maxLength":80,"minLength":1},"originCountry":{"type":"string","maxLength":80,"minLength":2},"portOfLoading":{"type":"string","maxLength":120,"minLength":1},"totalPackages":{"type":"integer","maximum":1000000,"minimum":0},"totalVolumeM3":{"type":"number","maximum":1000000,"minimum":0},"containerNumber":{"type":"string","maxLength":20,"minLength":1},"portOfDischarge":{"type":"string","maxLength":120,"minLength":1},"totalNetWeightKg":{"type":"number","maximum":1000000000,"minimum":0},"billOfLadingNumber":{"type":"string","maxLength":80,"minLength":1},"destinationCountry":{"type":"string","maxLength":80,"minLength":2},"totalGrossWeightKg":{"type":"number","maximum":1000000000,"minimum":0}},"additionalProperties":false}}},"responseSchema":{"type":"json","example":{"lines":[{"unit":"pcs","amount":null,"hsCode":"","packages":null,"quantity":100,"volumeM3":null,"unitPrice":null,"description":"Cotton t-shirts","netWeightKg":null,"grossWeightKg":46}],"status":"consistent","vessel":"","voyage":"","parties":[{"name":"Harbor Ink LLC","role":"shipper","address":""},{"name":"Northwind Paper Ltd","role":"consignee","address":""}],"currency":"","findings":[],"incoterm":"","checkedAt":"2026-11-02T19:00:00.000Z","reference":"","namedPlace":"","invoiceDate":"","limitations":["No customs declaration was submitted and no shipment was booked.","Duty rates, restrictions, sanctions status, and country-specific requirements are not invented.","An HS code candidate is not a customs classification.","Only the documents and shipment fields in this request are compared."],"totalAmount":null,"documentType":"bill_of_lading","incotermYear":"","invoiceNumber":"","originCountry":"","portOfLoading":"","totalPackages":null,"totalVolumeM3":null,"shipmentBooked":false,"containerNumber":"MSCU1234567","portOfDischarge":"","totalNetWeightKg":null,"billOfLadingNumber":"BL-1001","destinationCountry":"","totalGrossWeightKg":46,"declarationSubmitted":false}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_StbbRsPKhnu0XQgBw9z2c","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extracts structured freight data from a bill of lading document and checks it for consistency against a provided shipment record","exampleAgentPrompt":"I have a bill of lading PDF for our shipment of 100 cotton t-shirts on vessel MSC Aurora, voyage 024W, container MSCU1234567 — can you extract all the structured fields from it and check whether the gross weight of 46 kg and shipper Harbor Ink LLC match what's in the document?","exampleUseCases":[{"title":"Automate freight document data entry","prompt":"I just received a bill of lading PDF from our freight forwarder. Can you extract all the structured info from it — shipper, consignee, container number, HS codes, weights, and line items — so I can import it into our TMS without manual entry?"},{"title":"Validate B/L against booked shipment","prompt":"We booked a shipment of 500 units of ceramic tiles (HS code 6907.21) with gross weight 2,300 kg, shipper TileWorld GmbH, consignee BuildRight Inc, on vessel Ever Golden voyage 089E. Here's the bill of lading PDF — does it match what we booked, and are there any inconsistencies I should flag before customs clearance?"},{"title":"Customs pre-filing document check","prompt":"Before we file our import declaration, can you parse this bill of lading text and tell me the HS codes, declared values, net and gross weights, incoterm, and country of origin so our broker can verify everything is correct?"}],"resultDescription":"A JSON object containing the full extracted shipment data including bill of lading number, container number, vessel, voyage, parties with roles, line items with HS codes and weights, incoterm, currency, port of loading, port of discharge, and a consistency status ('consistent' or otherwise) with a findings array listing any discrepancies detected between the document and the provided shipment data. Also includes a limitations array noting what was not checked.","failureModes":["Unreadable or corrupted PDF returns extraction error","Document is not a bill of lading — wrong document type detected","Base64-encoded file exceeds 12 MB limit","Text exceeds 200,000 character limit","Missing required mediaType or fileBase64 fields returns validation error","Payment not completed via x402 returns 402 Payment Required","Partial or incomplete document yields empty or null fields with no findings"],"whenToPreferThis":"Use this endpoint when you need to programmatically extract structured freight data from bill of lading PDFs or text, especially when you also want to cross-check the extracted data against a known shipment record for consistency. Ideal for trade compliance automation, logistics agent workflows, or pre-customs-filing document checks. No account signup required — pay $0.05 USDC per call via x402 on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-11T13:06:32.298Z","isFirstParty":false,"canonicalSlug":"brainiac-bill-of-lading-extract-consistency-check-211645fd"}