{"uid":"cap_R8RIguuew4y6qK-YA3eNI","slug":"brainiac-shipping-address-validator-c543b3c3","name":"BRAINIAC Shipping Address Validator","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/returns-delivery/shipping-address-validate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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},"country":{"type":"string","maxLength":80},"ordered":{"type":"string","maxLength":40},"postcode":{"type":"string","maxLength":20},"promised":{"type":"string","maxLength":40},"addressId":{"type":"string","maxLength":80},"delivered":{"type":"string","maxLength":40},"windowDays":{"type":"number","maximum":3650,"minimum":0}},"additionalProperties":false},"maxItems":80},"window":{"type":"object","properties":{"days":{"type":"number","maximum":3650,"minimum":0},"from":{"type":"string","maxLength":40}},"additionalProperties":false},"returns":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"cost":{"type":"number","maximum":1000000000,"minimum":0},"reason":{"type":"string","maxLength":160},"weight":{"type":"number","maximum":1000000,"minimum":0},"carrier":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"orderId":{"type":"string","maxLength":80},"currency":{"type":"string","maxLength":12},"requested":{"type":"string","maxLength":40}},"additionalProperties":false},"maxItems":80},"addresses":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":80},"city":{"type":"string","maxLength":80},"line1":{"type":"string","maxLength":160},"line2":{"type":"string","maxLength":160},"region":{"type":"string","maxLength":80},"country":{"type":"string","maxLength":80},"postcode":{"type":"string","maxLength":20}},"additionalProperties":false},"maxItems":80}}},"responseSchema":{"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,"eventsInvented":false,"returnInitiated":false,"carrierContacted":false,"deliverabilityConfirmed":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_sCeixpN47Ax9xNU2rvQv9","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":"Structurally validates shipping addresses for format, completeness, and postcode shape across multiple countries, as part of a returns/delivery workflow.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Pre-shipment address check for e-commerce","prompt":"Before we ship this order, can you validate the customer's address: 42 High Street, London, SW1A 1AA, GB — and tell me if the postcode format is correct and whether anything is missing?"},{"title":"Bulk CSV address validation for returns","prompt":"I have a CSV file of 50 customer return addresses — can you validate all of them for correct format and completeness, and list any that have postcode errors or missing fields?"},{"title":"Return eligibility address screening","prompt":"We're processing a return request for order #ORD-8821 — the customer provided this address: 200 King St, Sydney, 2000, AU. Can you check if it's structurally valid and flag any issues before we approve the return?"}],"resultDescription":"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).","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T06:33:18.067Z","isFirstParty":false,"canonicalSlug":"brainiac-shipping-address-validator-c543b3c3"}