{"uid":"cap__z8OlcU033ZFRAucukzqT","slug":"returnability-aa076f4a","name":"Returnability","description":"Transaction-specific product return eligibility for Costco, Target, and Ulta, with evidence-backed conservative UNKNOWN and CONDITIONAL outcomes.","url":"https://returnability-prototype.vercel.app/paid/resolve","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"evidence":[{"source":"official retailer return policy"}],"merchant":"Target","confidence":0.78,"deadline_days":14,"return_status":"YES"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_A9yfaBHaxYxUJi91SRgj0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a specific product purchased at Costco, Target, or Ulta is eligible for return, given transaction context, with confidence scores and policy evidence.","exampleAgentPrompt":"I just bought a skincare serum at Ulta last week — can you check if it's returnable and how many days I have left to return it?","exampleUseCases":[{"title":"Post-purchase return eligibility check","prompt":"I bought a TV at Costco about 10 days ago and I'm not happy with it — can you check if I'm still eligible to return it and what the deadline is?"},{"title":"Ulta beauty product return decision","prompt":"I picked up a foundation at Ulta last Monday and the shade is totally wrong. Is it returnable, and how confident are you in that answer?"},{"title":"Target order return validation","prompt":"Can you check the return eligibility for an air fryer I ordered from Target two weeks ago? I want to know the status and how many days I have left."}],"resultDescription":"Returns a JSON object containing: return_status (YES, NO, CONDITIONAL, or UNKNOWN), a confidence score between 0 and 1, the number of days remaining or allowed for the return (deadline_days), the merchant name, and an evidence array citing official retailer return policy sources.","failureModes":["Unsupported merchant — endpoint only covers Costco, Target, and Ulta; other retailers will fail or return UNKNOWN","Insufficient transaction details result in low-confidence UNKNOWN or CONDITIONAL outcomes","Ambiguous or missing product category may trigger conservative CONDITIONAL status","Policy data may be stale if the retailer has updated its terms recently","Network or payment authorization errors may prevent resolution"],"whenToPreferThis":"Choose this endpoint when you need a transaction-specific return eligibility verdict for purchases at Costco, Target, or Ulta — especially when you need a confidence-scored, evidence-backed result rather than a generic policy summary. Prefer it over general-purpose web search or LLM reasoning when you need a structured YES/NO/CONDITIONAL outcome with deadline days and cited sources. Best suited for post-purchase agent workflows where a user wants an actionable answer about a specific item they bought.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:30:06.295Z","isFirstParty":false}