{"uid":"cap_J0jSwSxazdKSuggSCkJk4","slug":"agentline-phone-number-provisioning-b3e72190","name":"AgentLine Phone Number Provisioning","description":"Get a real phone number for your AI agent in under 10 minutes. Works with OpenClaw, Hermes Agent, and any LLM. Outbound calls, SMS, and inbound voice — one API. No telecom experience needed.","url":"https://api.agentline.cloud/v1/x402/numbers/buy","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"country":{"type":"string","description":"Country code (only 'US' supported)"},"voice_id":{"type":"string","description":"TTS voice preset (e.g. 'female-1') or Cartesia UUID"},"area_code":{"type":"string","description":"Preferred 3-digit US area code"},"agent_name":{"type":"string","description":"Display name for the voice agent"},"number_type":{"type":"string","description":"'local' or 'tollfree'"},"owner_phone":{"type":"string","description":"Owner's E.164 phone — calls from it enter task mode"},"system_prompt":{"type":"string","description":"Personality/behavior instructions spoken on ALL calls"},"transfer_number":{"type":"string","description":"E.164 fallback number for call transfers"},"initial_greeting":{"type":"string","description":"Opening line spoken when a call connects"},"voicemail_message":{"type":"string","description":"Message left if the call goes to voicemail"}}},"responseSchema":{"type":"object","properties":{"id":{"type":"string"},"agent":{"type":"object"},"status":{"type":"string"},"tx_hash":{"type":"string"},"agent_id":{"type":"string"},"lease_token":{"type":"string"},"owner_wallet":{"type":"string"},"phone_number":{"type":"string"},"lease_expires_at":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2","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":"$2/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_AD6yUiH2Oa559P3f1m3B-","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Provisions a real US phone number for an AI voice agent with configurable TTS voice, greeting, system prompt, and call-transfer settings.","exampleAgentPrompt":"Get my customer support voice agent a local US phone number in the 415 area code — name it 'SupportBot', use the female-1 voice, and have it greet callers with 'Hi, thanks for calling, how can I help you today?' with a fallback transfer to +14155550100.","exampleUseCases":[{"title":"AI receptionist for small business","prompt":"Set up a local phone number in the 212 area code for my AI receptionist called 'FrontDesk', use the female-1 voice, and have it greet callers with 'Welcome to Bloom Coffee, how can I help you?' — if a caller needs a human, transfer them to +12125550199."},{"title":"Toll-free line for AI sales agent","prompt":"Buy a toll-free number for my sales agent called 'SalesBot' — give it a male TTS voice and set its personality to be friendly and concise when pitching our SaaS product, with voicemail saying 'Sorry I missed you, leave a message and I'll follow up shortly.'"},{"title":"Owner task-mode hotline","prompt":"Provision a local US number in area code 650 for my personal AI assistant named 'TaskMaster' — register it to my number +16505550123 so when I call in it enters task mode, and use the female-1 voice preset."}],"resultDescription":"Returns a provisioned US phone number along with configuration details for the deployed voice agent, including the assigned number, agent name, voice preset, and any configured behaviors such as greeting, system prompt, and transfer routing.","failureModes":["Unsupported country code (only US is supported) returns a validation error","Invalid or unavailable area code results in provisioning failure","Malformed E.164 phone number for owner_phone or transfer_number causes rejection","Payment of $2 USDC not completed causes 402 Payment Required response","Invalid voice_id preset or Cartesia UUID returns an error","System prompt or greeting exceeds character limits"],"whenToPreferThis":"Use this endpoint when an AI agent needs a dedicated real US telephone number with configurable voice persona, inbound/outbound call support, SMS capability, and voicemail — especially when no telecom expertise is available and rapid provisioning (under 10 minutes) is required. Prefer this over Twilio or other raw telecom APIs when you want an agent-native setup with built-in TTS voice presets and system prompt configuration in a single API call paid via USDC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:56.493Z","isFirstParty":false}