agentutility(7)$ man return-policy-extract
/return-policy-extract
PRICE / CALL
$0.015
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
retailCATEGORY
uncategorized
STATUS
● live
NAME
return-policy-extract — turns a merchant's raw return policy text into structured refund terms an agent can act on before buying or returning something
SYNOPSIS
POST https://x402.agentutility.ai/return-policy-extract
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Turns a merchant's raw return policy text into structured refund terms an agent can act on before buying or returning something. Send the policy wording pasted from a terms page, packing slip, or support doc and get back the return window in days, restocking fee, condition requirements, whether an RMA is required, listed exceptions, and refund method. This is return policy extract, not advice: every field is pulled from the text you send, and anything the policy doesn't state comes back null instead of guessed. Use it as a return policy extract API, refund terms parser, restocking fee checker, or RMA parse tool ahead of a purchase or return decision.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| policy_text | string | Raw return/refund policy text to extract from. Alias: 'text'. | required |
| text | string | Alias for 'policy_text'. | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| input_chars | string | — |
| truncated | string | — |
| return_window_days | string | — |
| restocking_fee | string | — |
| condition_requirements | string | — |
| rma_required | string | — |
| exceptions | string | — |
| refund_method | string | — |
| model | string | — |
| source | string | — |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/return-policy-extract \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the return-policy-extract tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- retailreturnpolicyextractreturn-policy-extract
- methods
- POST
- cluster
- retail
- price
- $0.015 USDC per call
ADJACENT — other endpoints in retail
| endpoint | description | price |
|---|---|---|
| warranty-parse | Turns raw warranty terms text from a manual, warranty card, or manufacturer page into a structured coverage record an agent can check bef… | $0.015 |
| product-describe | Writes conversion-focused product descriptions and listing copy from a product name and optional category, audience, and attributes. | $0.01 |
| product-description | Product description API (alias of product-describe). | $0.01 |
| sku-normalize | Turns a messy marketplace product title or SKU string into structured attributes for catalog matching: brand, model, variant, capacity, c… | $0.01 |
| find-products | Find products API (alias of product-search). | $0.02 |
| product-search | Searches shopping results for a product query (and optional retailer), returning ranked results with product title, buy link, retailer do… | $0.02 |
| shop-search | Shopping search API (alias of product-search). | $0.02 |
SEE ALSO