# BRAINIAC Bill of Lading Extract & Consistency Check

> BRAINIAC Bill of Lading Extract & Consistency Check is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.05/call, status unknown (last checked 2026-11-11).

Extracts structured freight data from a bill of lading document and checks it for consistency against a provided shipment record

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/freight-customs/bill-of-lading-extract?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-bill-of-lading-extract-consistency-check-211645fd
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9aOmZayVyBtknizWDc9vb

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-bill-of-lading-extract-consistency-check-211645fd -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## 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

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.

## Request schema (JSON Schema)

```json
{
 "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
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-bill-of-lading-extract-consistency-check-211645fd/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)
