{"uid":"cap_sUNePzwQd3IGQFYlUk1Cg","slug":"stablephone-62e5da60","name":"StablePhone Phone Number Top-Up","description":"Top up a phone number","url":"https://stablephone.dev/api/number/topup","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"phone_number":{"type":"string","pattern":"^\\+1\\d{10}$"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"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":"x402","network":"base","amountUsd":"15","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"15","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_PjwlBWClGSVhrJ0MqAbM_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"15","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Extends the expiry of a purchased StablePhone phone number by 30 days from its current expiration date","exampleAgentPrompt":"Top up my StablePhone number +14155551234 to extend it by 30 more days — go ahead and pay the $15 to keep it active.","exampleUseCases":null,"resultDescription":"A confirmation that the phone number's expiry has been extended by 30 days from its current expiry date. Top-ups stack, so multiple renewals can be applied in advance. Anyone can top up a number, not just the original purchaser.","failureModes":["Invalid or unrecognized phone number — number not found in StablePhone system","Insufficient USDC balance or payment failure via x402 protocol","Phone number already permanently cancelled and ineligible for renewal","Network or API error returning 5xx status"],"whenToPreferThis":"Use this endpoint when you have an existing StablePhone dedicated number that is approaching its expiry date and need to extend it for another 30 days. Unlike buying a new number, this preserves the same phone number and caller ID. Top-ups can be stacked proactively before expiry. Choose this over re-purchasing when number continuity matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:43:18.376Z","isFirstParty":false}