# Returnability

> Returnability is a paid API for AI agents from returnability-prototype.vercel.app, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Checks whether a specific product purchased at Costco, Target, or Ulta is eligible for return, given transaction context, with confidence scores and policy evidence.

## Facts

- Endpoint: POST https://returnability-prototype.vercel.app/paid/resolve
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/returnability-aa076f4a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap__z8OlcU033ZFRAucukzqT

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 returnability-aa076f4a -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Transaction-specific product return eligibility for Costco, Target, and Ulta, with evidence-backed conservative UNKNOWN and CONDITIONAL outcomes.

## Output

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.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "evidence": [
   {
    "source": "official retailer return policy"
   }
  ],
  "merchant": "Target",
  "confidence": 0.78,
  "deadline_days": 14,
  "return_status": "YES"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/returnability-aa076f4a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from returnability-prototype.vercel.app](https://www.zero.xyz/host/returnability-prototype.vercel.app/llms.txt)