{"uid":"cap_9kQGkEvFfJlTx_u08tPTh","slug":"brainiac-freight-customs-data-completeness-checker-0b55c8ed","name":"BRAINIAC Freight Customs Data Completeness Checker","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/data-completeness?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":{"items":[{"field":"exporter","detail":"The field is present in the supplied documents.","status":"present"},{"field":"consignee","detail":"The field is present in the supplied documents.","status":"present"},{"field":"description","detail":"The field is present in the supplied documents.","status":"present"},{"field":"quantity","detail":"The field is present in the supplied documents.","status":"present"},{"field":"value","detail":"The field is present in the supplied documents.","status":"present"},{"field":"currency","detail":"The field is present in the supplied documents.","status":"present"},{"field":"grossWeight","detail":"The field is present in the supplied documents.","status":"present"},{"field":"origin","detail":"The field is present in the supplied documents.","status":"present"},{"field":"destination","detail":"The field is present in the supplied documents.","status":"present"},{"field":"reference","detail":"The field is present in the supplied documents.","status":"present"},{"field":"hsCode","detail":"A commodity code was supplied. It was not classified by this check.","status":"present"}],"status":"complete","findings":[{"code":"official_verification_unavailable","kind":"unavailable","detail":"Duty, restrictions, sanctions status, and country-specific filing requirements were not verified."}],"checkedAt":"2026-11-02T19:00:00.000Z","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."],"shipmentBooked":false,"declarationSubmitted":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_uGANX8x-A_KA26LPO7ccg","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":"Checks whether a freight shipment's documents and structured data contain all the fields required for customs clearance, returning a per-field presence/absence status report.","exampleAgentPrompt":"Can you check if our shipment documents are complete for customs? I'll paste in the commercial invoice text — it's for a shipment of 500 units of industrial pumps (HS code 8413.50), seller is Acme Corp (exporter), buyer is GlobalTrade Ltd (importer), 2500 kg gross weight, valued at USD 75,000 on DAP terms, invoice dated 2025-03-15.","exampleUseCases":[{"title":"Pre-clearance invoice audit","prompt":"Before we file the customs entry, can you run a data completeness check on this commercial invoice PDF I'm attaching? I need to know if any required fields like consignee, HS code, or value are missing."},{"title":"Automated export document QA","prompt":"We're shipping 200 cartons of electronics (HS code 8471.30) from our warehouse — can you check our shipping documents for completeness? The exporter is TechExport Inc, consignee is Asia Imports Co, gross weight 1200 kg, value USD 48,000 in EUR, EXW terms, invoice date 2025-04-10."},{"title":"Freight forwarder compliance pre-check","prompt":"My client just sent over their shipment details and I need to know what's missing before I can file. Can you check if the data is complete for customs — parties include seller Bright Foods (exporter) and GreenMart (importer), 3 line items with descriptions and quantities, but I'm not sure if the HS codes and origin are there?"}],"resultDescription":"A JSON object with an array of field-level status entries (each with field name, status of 'present'/'missing'/'incomplete', and a detail message), an overall 'status' string ('complete' or indicating gaps), a 'findings' array noting any checks that could not be performed (e.g. duty rates, sanctions), a 'checkedAt' timestamp, a 'limitations' list clarifying what was not verified, and booleans confirming no customs declaration was submitted and no shipment was booked.","failureModes":["Missing required file or text input — request rejected if neither 'file' nor 'text' nor 'shipment' is provided","File exceeds size limits (12MB base64 max) — returns error","Unsupported media type — only application/pdf and text/plain accepted","HS code format invalid (must be 4-14 chars) — validation error","Currency code not matching 3-letter ISO pattern — validation error","Payment not received or insufficient USDC — 402 response, no result returned","Truncated or unreadable PDF content — fields may show as missing even if present in original document"],"whenToPreferThis":"Use this endpoint when you need a fast, accountless, pay-per-call check of whether a freight shipment's documents and structured data contain all customs-required fields before filing or forwarding. It is ideal for automated pre-clearance QA pipelines, freight forwarder document validation, or agent workflows that process commercial invoices and bills of lading. Prefer this over manual document review or full customs filing services when you only need a completeness gap analysis, not an actual declaration submission or duty calculation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T00:37:22.398Z","isFirstParty":false,"canonicalSlug":"brainiac-freight-customs-data-completeness-checker-0b55c8ed"}