{"uid":"cap_Pq0jYdaqaqiQzCN8LE6GT","slug":"stablephone-topup-8fc10a01","name":"StablePhone Number Top-Up","description":"Extend a phone number by 30 days from current expiry ($15.00 via x402). Top-ups stack. Anyone can top up any number.","url":"https://stablephone.dev/api/number/topup?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["phone_number"],"properties":{"phone_number":{"type":"string","pattern":"^\\+1\\d{10}$"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["success","phone_number","expires_at"],"properties":{"success":{"type":"boolean","const":true},"expires_at":{"type":"string"},"phone_number":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":["phone","call","voice","ai-call","imessage","ai","social"],"displayCostAmount":"15","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":"$15/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"15","per":"call","confidence":"exact"},{"kind":"static","protocol":"x402","network":"base","amountUsd":"15.00","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QBCjcl581hdyVkNrj4Ec-","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"15","costPer":"request","priority":0,"asset":"0x20c000000000000000000000b9537d11c60e8b50","unit":"request","depositMicros":null,"planRef":null},{"uid":"pm_TETTD5PfyU8rRU7-1Bsn7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"15.00","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"StablePhone","brandSlug":"stablephone","brandBaseUrl":"https://stablephone.dev","brandDocsUrl":"https://stablephone.dev","whatItDoes":"Extends the expiry of an existing US phone number by 30 days, stackable, payable via x402 at $15 USDC per call.","exampleAgentPrompt":"Top up my StablePhone number +12125551234 for another 30 days.","exampleUseCases":null,"resultDescription":"Returns a JSON object with success: true, the phone_number that was topped up, and the new expires_at timestamp reflecting the 30-day extension from the previous expiry.","failureModes":["Invalid phone number format (must match ^\\+1\\d{10}$) — returns validation error","Phone number not found in StablePhone system","Payment failure via x402 — insufficient USDC balance or payment not accepted","Network or server error returning non-200 response"],"whenToPreferThis":"Use this endpoint when you need to extend the active period of an existing US phone number on StablePhone by 30 days. Particularly useful for keeping a dedicated outbound caller ID active, preventing expiry, or stacking multiple renewals in advance. Anyone can top up any number — no ownership authentication required, unlike other StablePhone endpoints.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-09T18:32:05.312Z","isFirstParty":false,"canonicalSlug":"stablephone-topup-8fc10a01"}