{"openapi":"3.1.0","info":{"title":"Refund Rights API","version":"0.1.0","description":"A fully local, hand-curated and web-verified general consumer refund/return-rights reference across the US, EU and UK — change-of-mind returns, faulty-goods rights, the EU's 14-day withdrawal right and its exceptions, the US FTC Cooling-Off Rule, a scenario considerations tool, and a glossary. General information only, not legal advice.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://refundrights.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/refundrights/docs"},"termsOfService":"https://connectorbay.com/refundrights/terms"},"servers":[{"url":"https://refundrights.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/refundrights/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/jurisdiction_overview":{"post":{"operationId":"jurisdiction_overview","summary":"Full general consumer refund/return-rights picture for one jurisdiction — the headline rule, key points,","description":"Full general consumer refund/return-rights picture for one jurisdiction — the headline rule, key points,\n    and (where relevant) the specific statutory tiers or rules. Use for \"what are my return rights in the UK\",\n    \"does the US have a right to return things\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"jurisdiction":{"description":"'US', 'EU' or 'UK' (aliases like 'United States', 'Britain' also work).","examples":["EU"],"minLength":1,"title":"Jurisdiction","type":"string"}},"required":["jurisdiction"],"title":"jurisdiction_overviewArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/compare_jurisdictions":{"post":{"operationId":"compare_jurisdictions","summary":"A side-by-side comparison of the US, EU and UK on change-of-mind returns and faulty-goods rights. Use for","description":"A side-by-side comparison of the US, EU and UK on change-of-mind returns and faulty-goods rights. Use for\n    \"compare US and EU return rights\", \"which country has the best consumer return protection\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"compare_jurisdictionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/eu_withdrawal_right":{"post":{"operationId":"eu_withdrawal_right","summary":"Full detail on the EU's 14-day 'right of withdrawal' for distance (online/phone/doorstep) purchases: when","description":"Full detail on the EU's 14-day 'right of withdrawal' for distance (online/phone/doorstep) purchases: when\n    the 14 days starts, who pays return shipping, who pays the refund and when, and the legal basis. Use for \"how\n    long do I have to return something I bought online in Europe\", \"who pays for return shipping in the EU\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"eu_withdrawal_rightArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/eu_withdrawal_exceptions":{"post":{"operationId":"eu_withdrawal_exceptions","summary":"Lists the categories of goods/services the EU's 14-day withdrawal right does NOT cover (custom goods,","description":"Lists the categories of goods/services the EU's 14-day withdrawal right does NOT cover (custom goods,\n    perishables, sealed hygiene items, digital content already started, etc.), or keyword-matches a described item\n    or situation against them. Use for \"can I return a custom-made sofa in the EU\", \"does the 14-day rule cover\n    concert tickets\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item_or_situation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Describe the item or situation to match against known exceptions; omit to list all.","title":"Item Or Situation"}},"title":"eu_withdrawal_exceptionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/uk_faulty_goods_tiers":{"post":{"operationId":"uk_faulty_goods_tiers","summary":"The UK Consumer Rights Act 2015's three-tier structure for faulty goods: the 30-day short-term right to","description":"The UK Consumer Rights Act 2015's three-tier structure for faulty goods: the 30-day short-term right to\n    reject for a full refund, the 30-180 day repair-or-replace tier, and the 6-month-to-6-year extended tier with\n    its shifting burden of proof — plus how this differs from an ordinary change-of-mind return. Use for \"what\n    happens if my UK purchase breaks after a month\", \"how long do I have to reject a faulty item in the UK\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"uk_faulty_goods_tiersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/us_return_basics":{"post":{"operationId":"us_return_basics","summary":"Explains why there's no general US federal right to return non-defective merchandise, what state","description":"Explains why there's no general US federal right to return non-defective merchandise, what state\n    return-policy disclosure laws and implied-warranty law DO provide, and the two narrow federal rules that do\n    exist. Use for \"is there a federal law that lets me return anything\", \"can a US store legally refuse all\n    returns\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"us_return_basicsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/us_cooling_off_rule":{"post":{"operationId":"us_cooling_off_rule","summary":"Full detail on the FTC Cooling-Off Rule: the narrow 3-business-day cancellation right for certain in-person","description":"Full detail on the FTC Cooling-Off Rule: the narrow 3-business-day cancellation right for certain in-person\n    sales made away from a seller's normal place of business, its dollar thresholds, its requirements, and\n    exactly what it does NOT cover (online orders included). Use for \"can I cancel a door-to-door sale\", \"does the\n    3-day right to cancel apply to online purchases\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"us_cooling_off_ruleArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/considerations_for_scenario":{"post":{"operationId":"considerations_for_scenario","summary":"Takes a plain-language description of a purchase/return situation and surfaces the relevant considerations","description":"Takes a plain-language description of a purchase/return situation and surfaces the relevant considerations\n    to think through — never a yes/no verdict, since the real answer depends on exactly where you bought it, the\n    seller's own policy, and your specific jurisdiction's law. Use for \"can I return this custom sofa\", \"what are\n    my options if my UK laptop broke after two months\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"scenario":{"description":"Describe your purchase/return situation in plain language.","examples":["I bought a custom-made sofa online in Germany and changed my mind","my UK laptop stopped turning on after 2 months"],"minLength":1,"title":"Scenario","type":"string"}},"required":["scenario"],"title":"considerations_for_scenarioArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/refundrights_glossary":{"post":{"operationId":"refundrights_glossary","summary":"Defines consumer refund/return-rights terms — cooling-off period, right of withdrawal, distance contract,","description":"Defines consumer refund/return-rights terms — cooling-off period, right of withdrawal, distance contract,\n    short-term right to reject, restocking fee, chargeback, implied warranty of merchantability. Use for \"what\n    does chargeback mean\", \"what's the short-term right to reject\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"refundrights_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}