{"uid":"cap_J0wpyM9I3QzzvvUCGAcgh","slug":"brainiac-returns-delivery-exception-classifier-fa7600c3","name":"BRAINIAC Returns Delivery Exception Classifier","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/exception-classify?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":{"items":[{"at":"2026-11-02T15:00:00.000Z","id":"E-1","code":"refused","source":"event","orderId":"O-1","category":"refused","confirmed":false,"interpretation":"stated"},{"at":"2026-11-03T15:00:00.000Z","id":"E-2","code":"erase","source":"event","orderId":"O-2","category":"unrecognized","confirmed":false,"interpretation":"none"}],"status":"classified","findings":[{"code":"unlabeled_line","kind":"ignored","detail":"Lines without a recognized label were not read and their text was not copied.","subject":""}],"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_aNsSjNoJhgfIO64t1834Q","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":"Classifies delivery exception events (refused, damaged, delayed, undeliverable, returned, etc.) for e-commerce orders and returns, using supplied order, event, address, and rate data.","exampleAgentPrompt":"I have a batch of delivery events for some orders — event E-1 on order O-1 has code 'refused' and event E-2 on order O-2 has code 'erase'. Can you classify what type of delivery exceptions these are and tell me whether any qualify for a refund?","exampleUseCases":[{"title":"Classify refused and undeliverable shipments","prompt":"I have 20 orders with carrier exception codes like 'refused', 'undeliverable', and 'returned_to_sender'. Can you classify each exception event into standard categories and tell me which ones are confirmed delivery failures?"},{"title":"Identify damaged or delayed delivery failures","prompt":"My logistics platform recorded exception events with codes like 'damaged', 'delayed', and 'held' for a set of shipments. Can you classify these events and tell me which category each one falls into?"},{"title":"Return cost assessment with rate rules","prompt":"I need to classify delivery exception events for 15 orders and calculate potential return costs. I have carrier return rates and a 30-day return window — can you classify the exceptions and apply the rates to estimate return costs?"}],"resultDescription":"A JSON object containing: a list of classified exception items (each with event ID, order ID, timestamp, exception category, interpretation, and confirmation status), overall classification status, findings (warnings about unrecognized or ignored data), and flags indicating whether a refund was granted, return was initiated, carrier was contacted, events were invented, or deliverability was confirmed. Limitations are explicitly listed.","failureModes":["Unrecognized carrier exception codes are classified as 'unrecognized' rather than a specific category","Lines or fields without recognized labels are ignored and noted in findings","Postcode validation only covers AU, CA, DE, ES, FR, GB, IT, NL, and US — others are not checked","Return cost calculation requires caller-supplied rates; no external carrier lookup is performed","Input exceeding 80 events or 80 orders is rejected due to schema maxItems limits","No carrier account is contacted and no live tracking data is retrieved"],"whenToPreferThis":"Use this endpoint when you need to programmatically classify delivery exception event codes into standard categories (refused, damaged, delayed, undeliverable, returned, etc.) without contacting any carrier API. Ideal for post-hoc logistics analysis, return automation workflows, or compliance auditing where you have raw event data and need structured exception categories. Prefer this over manual categorization or carrier-specific APIs when you want a neutral, rule-based classifier that handles multiple carriers and exception types in a single call at a fixed $0.04 USDC cost.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:19.935Z","isFirstParty":false,"canonicalSlug":"brainiac-returns-delivery-exception-classifier-fa7600c3"}