{"uid":"cap_ZuYMfRYPxOveyEeV1Oszj","slug":"bill-negotiation-api-b68c365d","name":"Bill Negotiation API","description":"Autonomous bill-negotiation phone calls for agents.","url":"https://bill-negotiation-api.lewis-6d8.workers.dev/negotiate?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"20","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$20/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"20","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7PIQSHnIxhoY5iN9KqEE8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"20","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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).","exampleUseCases":[{"title":"Lower monthly cable TV bill","prompt":"Call the retention line for my Spectrum cable TV plan and negotiate my bill down — I'm currently paying $120 a month and want to get it under $80. My account number is 987654321, the account is under John Smith, and the PIN is 3391."},{"title":"Reduce internet service rate","prompt":"My AT&T internet bill just jumped to $95 a month after my promo expired. Can you call their retention department at +18009192000 and get me a better rate — ideally around $60? Account is under Sarah Johnson, account number 456789123, PIN is 7712."},{"title":"Negotiate lower phone plan cost","prompt":"I've been on the same Verizon plan for two years and I'm paying $85 a month — way too much. Call their retention line and see if you can get that down to $55 or less. My account number is 112233445, it's under Mike Torres, and my account PIN is 5508."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T06:37:15.249Z","isFirstParty":false,"canonicalSlug":"bill-negotiation-api-b68c365d"}