# BRAINIAC Freight Customs Packing List Validator

> BRAINIAC Freight Customs Packing List Validator is a paid API for AI agents from www.brainiac.software, paid per call via x402, $0.04/call, status unknown (last checked 2026-11-17).

Validates and cross-checks a freight packing list document (PDF, plain text, or structured shipment data) for internal consistency and customs-readiness, returning findings and a status.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/freight-customs/packing-list-validate?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brainiac-freight-customs-packing-list-validator-e1e7dd28
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hAaHXW94lX3J0xo66C9rb

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-freight-customs-packing-list-validator-e1e7dd28 -d '<json body>'
```

Example prompt: Can you validate this packing list PDF for our shipment SHP-1001 — 100 pcs of cotton t-shirts at $0 unit price, net weight 40 kg, gross weight 46 kg — and check if everything is internally consistent for customs?

## When to prefer this

Use this endpoint when you need a fast, pay-per-call, no-account validation of a freight packing list — especially for pre-shipment QA, automated trade document pipelines, or customs preparation checks. It is well-suited for agents that process structured shipment data or raw packing list PDFs and need to surface inconsistencies (weight totals, HS code format, missing parties) before submission. Prefer it over manual review or heavyweight ERP validation when speed and cost per call matter. Note it does not check live duty rates, sanctions, or submit to customs authorities.

## Known failure modes

- Oversized file: base64 input exceeds 12MB limit — truncate or split document
- Unsupported media type: only application/pdf and text/plain are accepted
- Missing required fields: 'description' is required for each line item
- Invalid date format: invoiceDate must be ISO 8601 date (YYYY-MM-DD)
- Invalid currency code: must be exactly 3 alphabetic characters
- Too many line items: maximum 80 lines per request
- Payment failure: x402 USDC payment on Base must succeed before result is returned
- Ambiguous or illegible PDF content may result in incomplete extraction with findings noting limitations

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

Returns a JSON object with: overall validation status ('consistent' or error/warning variants), a list of findings (discrepancies, missing fields, anomalies), extracted and normalized line items (description, quantity, unit, HS code, weights, volume, unit price, amount, packages), party list with roles, vessel/voyage, incoterm, currency, invoice date, totals for weight/volume/packages/amount, document type, checked timestamp, and a list of limitations (e.g. no live duty rates, no sanctions check).

## 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": 0,
    "hsCode": "",
    "packages": null,
    "quantity": 100,
    "volumeM3": null,
    "unitPrice": 0,
    "description": "Cotton t-shirts",
    "netWeightKg": 40,
    "grossWeightKg": 46
   }
  ],
  "status": "consistent",
  "vessel": "",
  "voyage": "",
  "parties": [],
  "currency": "",
  "findings": [],
  "incoterm": "",
  "checkedAt": "2026-11-02T19:00:00.000Z",
  "reference": "SHP-1001",
  "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": "packing_list",
  "incotermYear": "",
  "invoiceNumber": "",
  "originCountry": "",
  "portOfLoading": "",
  "totalPackages": null,
  "totalVolumeM3": null,
  "shipmentBooked": false,
  "containerNumber": "",
  "portOfDischarge": "",
  "totalNetWeightKg": 40,
  "billOfLadingNumber": "",
  "destinationCountry": "",
  "totalGrossWeightKg": 46,
  "declarationSubmitted": false
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-freight-customs-packing-list-validator-e1e7dd28/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)
