# BRAINIAC Shipping Address Validator

> BRAINIAC Shipping Address 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).

Structurally validates shipping addresses for format, completeness, and postcode shape across multiple countries, as part of a returns/delivery workflow.

## Facts

- Endpoint: POST https://www.brainiac.software/api/v1/returns-delivery/shipping-address-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-shipping-address-validator-c543b3c3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_R8RIguuew4y6qK-YA3eNI

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-shipping-address-validator-c543b3c3 -d '<json body>'
```

Example prompt: Can you check whether this shipping address is valid and correctly formatted — 10 Example Street, Austin, TX 1234, US — and flag any postcode or structural issues?

## When to prefer this

Use this endpoint when you need lightweight, structural address validation without a live carrier API call — ideal for pre-shipment screening, return eligibility checks, or batch-cleaning customer address records. It is especially suited for e-commerce agents that need to flag malformed postcodes across AU, CA, DE, ES, FR, GB, IT, NL, and US. Prefer it over live geocoding or carrier APIs when you only need format/completeness checks and want a fixed $0.04 USDC cost with no account required.

## Known failure modes

- Postcode shape only checked for AU, CA, DE, ES, FR, GB, IT, NL, US — other countries return not_checked
- Missing required fields (line1, city, postcode, country) result in incomplete flag and issue codes rather than a hard error
- No live carrier or postal API is queried — deliverabilityConfirmed will always be false
- Truncated or malformed input CSV/JSON may cause parsing errors or incomplete results
- Addresses for unsupported country codes may pass structural checks without meaningful validation

## 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 a list of validated addresses, each annotated with format match status (matches, differs, not_checked), completeness flag, structural classification, and an array of specific issues (e.g. postcode_format, line1_missing, city_missing, country_missing). Also includes overall findings, a checkedAt timestamp, and a list of limitations (e.g. no carrier lookup, no live deliverability confirmation).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "csv": {
   "type": "string",
   "maxLength": 200000
  },
  "file": {
   "type": "object",
   "required": [
    "mediaType",
    "fileBase64"
   ],
   "properties": {
    "filename": {
     "type": "string",
     "maxLength": 180,
     "minLength": 1
    },
    "mediaType": {
     "enum": [
      "text/plain",
      "text/csv",
      "application/json"
     ],
     "type": "string"
    },
    "fileBase64": {
     "type": "string",
     "maxLength": 12000000,
     "minLength": 1
    }
   },
   "additionalProperties": false
  },
  "json": {
   "type": "string",
   "maxLength": 200000
  },
  "text": {
   "type": "string",
   "maxLength": 200000
  },
  "rates": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "basis": {
      "type": "string",
      "maxLength": 40
     },
     "amount": {
      "type": "number",
      "maximum": 1000000000,
      "minimum": 0
     },
     "carrier": {
      "type": "string",
      "maxLength": 80
     },
     "country": {
      "type": "string",
      "maxLength": 80
     },
     "currency": {
      "type": "string",
      "maxLength": 12
     }
    },
    "additionalProperties": false
   },
   "maxItems": 40
  },
  "rules": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "value"
    ],
    "properties": {
     "name": {
      "type": "string",
      "maxLength": 40,
      "minLength": 1
     },
     "value": {
      "type": "string",
      "maxLength": 40
     }
    },
    "additionalProperties": false
   },
   "maxItems": 8
  },
  "events": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "at": {
      "type": "string",
      "maxLength": 40
     },
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "code": {
      "type": "string",
      "maxLength": 80
     },
     "detail": {
      "type": "string",
      "maxLength": 500
     },
     "orderId": {
      "type": "string",
      "maxLength": 80
     }
    },
    "additionalProperties": false
   },
   "maxItems": 80
  },
  "orders": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "id": {
      "type": "string",
      "maxLength": 80
     },
     "status": {
      "type": "string",
      "maxLength": 80
     },
     "weight": {
      "type": "number",
      "maximum": 1000000,
      "minimum": 0
     },
     "carrier": {
      "type": "string",
      "maxLength": 80
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "checked",
  "findings": [],
  "addresses": [
   {
    "id": "A-2",
    "city": "Austin",
    "line1": "10 Example Street",
    "line2": "",
    "format": "differs",
    "issues": [
     {
      "code": "postcode_format",
      "detail": "The postcode does not match the published shape for this country code. Delivery was not checked."
     }
    ],
    "region": "TX",
    "country": "US",
    "complete": true,
    "postcode": "1234",
    "structure": "format",
    "countryKnown": true,
    "interpretation": "stated",
    "deliverabilityConfirmed": false
   },
   {
    "id": "A-1",
    "city": "London",
    "line1": "10 Example Street",
    "line2": "",
    "format": "matches",
    "issues": [],
    "region": "",
    "country": "GB",
    "complete": true,
    "postcode": "SW1A 1AA",
    "structure": "present",
    "countryKnown": true,
    "interpretation": "stated",
    "deliverabilityConfirmed": false
   },
   {
    "id": "A-3",
    "city": "",
    "line1": "",
    "line2": "",
    "format": "not_checked",
    "issues": [
     {
      "code": "line1_missing",
      "detail": "The first address line was not supplied."
     },
     {
      "code": "city_missing",
      "detail": "The city was not supplied."
     },
     {
      "code": "postcode_missing",
      "detail": "The postcode was not supplied."
     },
     {
      "code": "country_missing",
      "detail": "The country was not supplied."
     }
    ],
    "region": "",
    "country": "",
    "complete": false,
    "postcode": "",
    "structure": "incomplete",
    "countryKnown": false,
    "interpretation": "stated",
    "deliverabilityConfirmed": false
   }
  ],
  "checkedAt": "2026-11-04T12:00:00.000Z",
  "limitations": [
   "Orders, addresses, events, returns, and rates are copied only from labeled fields supplied by the caller.",
   "No carrier tracking event is added. A code is classified only when it is failed, delivery_failed, not_delivered, undeliverable, refused, damaged, delayed, late, held, hold, address, address_issue, bad_address, returned, returned_to_sender, rts, or exception.",
   "An address check is structural. Postcode shape is checked only for AU, CA, DE, ES, FR, GB, IT, NL, and US. Delivery is not confirmed.",
   "A return cost uses only a supplied rate, and a window uses only a supplied day count. No refund is granted.",
   "No carrier account is contacted and no return is initiated."
  ],
  "refundGranted": false,
  "eventsInvent
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brainiac-shipping-address-validator-c543b3c3/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)
