{"uid":"cap_8CigR8mDPdYqWxkVqrx48","slug":"brainiac-return-reason-analyzer-3d2c2ff8","name":"BRAINIAC Return Reason Analyzer","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/return-reason-analyze?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":"analyzed","reasons":[{"count":3,"reason":"size","pattern":true,"refundGranted":false,"interpretation":"stated"},{"count":1,"reason":"color","pattern":false,"refundGranted":false,"interpretation":"stated"},{"count":1,"reason":"erase","pattern":false,"refundGranted":false,"interpretation":"stated"}],"findings":[],"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_zAZbWtnKVh4K59nyimO_s","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":"Analyzes e-commerce return data to identify patterns, classify return reasons, and surface findings about why customers are returning products","exampleAgentPrompt":"I have a CSV export of our last 500 returns from Shopify — can you analyze it to find the most common return reasons, flag any patterns, and tell me which reasons are stated vs interpreted?","exampleUseCases":[{"title":"Spotting sizing return patterns","prompt":"Here's a JSON export of 200 customer returns from last quarter — analyze the return reasons and tell me if 'size' or 'fit' issues show up as a pattern across multiple orders."},{"title":"Post-holiday return reason audit","prompt":"I've got a CSV with all our December return events and order data — can you classify the return reasons and surface the top findings so I know what drove the spike this year?"},{"title":"Carrier damage return classification","prompt":"I have tracking events and return records for 80 orders where customers cited damage or delivery issues — analyze them to classify the return reasons and flag which ones look like carrier-related patterns."}],"resultDescription":"Returns a JSON object with a list of return reasons (each with count, pattern flag, refund granted status, and interpretation type), top-level findings, a checkedAt timestamp, refundGranted/returnInitiated/carrierContacted boolean flags, and a limitations array explaining what the analysis does and does not cover. No carrier systems are contacted and no refunds are initiated.","failureModes":["Input data missing required fields — analysis may produce empty or partial reason list","CSV or JSON malformed — parsing fails and no reasons are returned","Return reason codes not recognized — classified as unmatched or omitted","Postcode validation limited to AU, CA, DE, ES, FR, GB, IT, NL, US — other countries skipped","No shipping rates supplied — cost calculations absent from output","Exceeds maxItems limits on orders (80) or events (80) — truncation or rejection","No return data provided — empty reasons array returned"],"whenToPreferThis":"Use this endpoint when you have raw e-commerce return data (orders, events, reasons) in CSV, JSON, or text form and need a structured classification and pattern analysis of why returns are occurring. It is ideal for post-period audits, operational reviews, or agent workflows that need to surface return reason insights without connecting to carrier systems or initiating any actions. Prefer this over general-purpose LLM analysis when you want consistent structured output with explicit limitation disclosures and boolean safety flags (no carrier contacted, no refund granted).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-12T18:39:48.505Z","isFirstParty":false,"canonicalSlug":"brainiac-return-reason-analyzer-3d2c2ff8"}