# Bill Negotiation API

> Bill Negotiation API is a paid API for AI agents from bill-negotiation-api.lewis-6d8.workers.dev, paid per call via x402, $20/call, status unknown (last checked 2026-10-10).

Places an autonomous AI-driven phone call to a bill provider's retention line to negotiate a lower monthly rate on behalf of a user.

## Facts

- Endpoint: POST https://bill-negotiation-api.lewis-6d8.workers.dev/negotiate?utm_source=zero.xyz
- Price: $20/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bill-negotiation-api-b68c365d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZuYMfRYPxOveyEeV1Oszj

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 bill-negotiation-api-b68c365d -d '<json body>'
```

Example prompt: Call Comcast's retention line at +18005551234 and negotiate my internet bill down from $90.00 to $60.00 per month — my account number is 123456789 and the account is under Jane Doe (PIN: 4821).

## When to prefer this

Use this endpoint when a user wants to autonomously reduce a recurring monthly bill (telecom, cable, internet, utilities) without manually calling the provider themselves. Best suited for services that have a known retention phone number and account credentials. Prefer this over manual negotiation scripts or chat-based alternatives when a live phone call to a retention department is required.

## Known failure modes

- Retention line is unreachable or goes unanswered — call fails with no negotiation outcome
- Account PIN or account number is incorrect — provider refuses to authenticate
- Provider retention team declines to offer any discount — negotiation unsuccessful
- Invalid E.164 phone number format causes request validation error
- Callback URL is unreachable and result notification fails to deliver
- Account holder name does not match provider records — call rejected

## How this service works

Autonomous bill-negotiation phone calls for agents.

## Output

The agent receives the outcome of the negotiation phone call, including whether a lower rate was secured, the new negotiated monthly amount if successful, and optionally a callback notification to the provided URL with the full result details.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "bill_type",
  "account_number",
  "account_holder_name",
  "target_monthly_amount",
  "current_monthly_amount",
  "retention_phone_number"
 ],
 "properties": {
  "bill_type": {
   "enum": [
    "isp",
    "cell",
    "insurance"
   ],
   "type": "string"
  },
  "account_pin": {
   "type": "string"
  },
  "callback_url": {
   "type": "string"
  },
  "account_number": {
   "type": "string"
  },
  "account_holder_name": {
   "type": "string"
  },
  "target_monthly_amount": {
   "type": "string",
   "description": "decimal like 60.00"
  },
  "current_monthly_amount": {
   "type": "string",
   "description": "decimal like 90.00"
  },
  "retention_phone_number": {
   "type": "string",
   "description": "E.164 like +18005551234"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bill-negotiation-api-b68c365d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bill-negotiation-api.lewis-6d8.workers.dev](https://www.zero.xyz/host/bill-negotiation-api.lewis-6d8.workers.dev/llms.txt)