---
title: Offers Guide
description: 'Accept and manage home warranty claims through customizable offers'
sidebar:
  label: Guide
---

Offers are the core mechanism for resolving home warranty claims, providing customers with replacement products,
upgrades, or buyout options.

## Benefits

- **Operational:** Automate claim processing, standardize workflows, and reduce manual work
- **Financial:** Generate upgrade revenue while reducing processing costs
- **Customer:** Provide clear options, quick resolutions, and transparent self-service choices

## Core Concepts

**Replacement Product**

Base product covered by warranty

**Buyout**

Cash settlement option for claim resolution

**Upgrade**

Premium product available for additional cost

**Credit**

Amount the customer has to spend in the marketplace. Defaults to the price of the replacement product and add-ons;
set `creditAmount` when creating the offer to use your own value.

**Difference Payment**

Amount customer pays for upgrade (upgrade price minus credit)

**Add-On**

Optional services or parts (e.g. Install, Disposal, recommended parts) bundled with the replacement at offer
creation.

**Curator**

The role that prepares an offer — chooses the replacement, attaches add-ons, and may accept on the customer's
behalf.

## Offer States

1. **Pending**

    Initial offer creation **Next states:** - Generating Upgrades - Ready

2. **Generating Upgrades**

    Computing upgrade options **Next states:** - Ready

3. **Ready**

    Prepared to send to customer **Next states:** - Awaiting Customer - Canceled

4. **Awaiting Customer**

    Sent to customer **Next states:** - Order Placed - Buyout Selected - Expired - Canceled

### Terminal States

**Order Placed**

Customer selected replacement product

**Buyout Selected**

Customer chose cash settlement

**Canceled**

Offer terminated

**Expired**

Past validity period

## Customer Experience

**Accept Replacement**

Get your covered replacement product delivered and installed at no additional cost.

**Choose Buyout**

Receive a cash settlement directly to handle the replacement yourself.

**Select Upgrade**

Choose an upgrade product and pay the difference between your coverage and the upgrade price.

## Next Steps

1. **Review Documentation**

    Read through API reference and authentication requirements

2. **Development**

    Set up test environment and create sample offers

3. **Testing**

    Test customer experience and monitor metrics

4. **Production**

    Go live with your integration

## Endpoints

**[Offers endpoints](/api-reference/offers)**

Every endpoint with parameters, response schemas, and code samples.