{"access":{"authentication":{"format":"L402 {macaroon}:{proof_of_payment}","header":"Authorization","protocols":["L402","MPP"],"format_mpp":"Payment <base64url_json>"},"endpoint":"https://sats4ai.com/api/l402/ai-call","method":"POST"},"content_type":"api","cover_url":"","description":"Place a two-way AI voice agent phone call. An AI agent calls the specified number, follows your instructions (system prompt), has a real conversation, and returns a full transcript with structured analysis.\n\nAutomatically retries on voicemail/no-answer (up to 3 attempts, included in payment). May return state=\"pending_confirm\" with clarification questions if the task is missing critical info — POST with action=\"confirm\" to proceed.\n\nParameters (JSON body):\n```\n{\n    \"phone_number\": \"+1234567890\",       // Required. E.164 format\n    \"task\": \"Call this business...\",      // Required. Instructions for the AI agent\n    \"duration_minutes\": 3,               // Optional. Deposit for 1-10 min (default 3). Unused time refunded.\n    \"language\": \"en-US\",                 // Optional. Language code (default en-US)\n    \"begin_message\": \"Hi, I am...\"       // Optional. Agent's opening line\n    \"refund_address\": \"you@wallet.com\"   // Optional. Lightning address for auto-refund of unused time\n}\n```\n\nDeposit billing: You pay for requested minutes upfront. Unused time is automatically refunded. Provide a `refund_address` (Lightning address) for instant refund, or claim via POST /api/claim-refund after the call.\n\nConfirm after push-back:\n```\n{ \"action\": \"confirm\", \"session_id\": \"...\", \"answers\": {...} }\n```\n\nReturns `call_id` immediately. Poll `GET /api/l402/ai-call?call_id=xxx` for transcript, results, and refund status (no extra payment).\nOn complete task failure, a LNURL-withdraw refund link is returned in the error response.\n\nThe AI agent can: ask questions, take notes, navigate phone menus (outbound DTMF), and end the call. It cannot transfer the call to a third party, and identifies as an automated assistant when asked.\n\nScam screening is in place: tasks that impersonate a company or government, threaten or harass the recipient, or solicit credentials or codes are flagged after payment, the call is NOT placed, and the payment is NOT automatically refunded; a human review can be requested via the docs page. Per-destination send limits apply.","name":"AI Phone Call","pricing":{"description":"Twilio telephony cost + Retell AI cost per minute, with 15% margin","retell_usd_per_min":0.102,"example_us_call_3min":"~150-250 sats"},"languages":["en-US","en-GB","fr-FR","es-ES","zh-CN","ja-JP","de-DE","multi"]}