# BRAINIAC Freight Customs Data Completeness Checker

> BRAINIAC Freight Customs Data Completeness Checker 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).

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.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/freight-customs/data-completeness?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-data-completeness-checker-0b55c8ed
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9kQGkEvFfJlTx_u08tPTh

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-data-completeness-checker-0b55c8ed -d '<json body>'
```

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

## When to prefer this

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.

## Known failure modes

- 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

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

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-freight-customs-data-completeness-checker-0b55c8ed/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)
