Renew Phone Line
Renew your phone line for another 30 days. $60/mo includes 5,000 free texts. Requires Privy bearer + x402 payment.
Renew your phone line for another 30 days. $60/mo includes 5,000 free texts. Requires Privy bearer + x402 payment.
Authorization
x402 bearer x402 payment header. When a request is sent without payment, the server returns 402 Payment Required with the price and payTo address. The caller signs an EIP-3009 transferWithAuthorization for USDC on Base and resubmits with the signed payment in this header. See https://docs.x402.org
In: header
Privy access token (dashboard sessions, ~1h TTL) or long-lived dial_live_* / dial_test_* API key minted from /dashboard/billing. API keys are scope-gated per route (sms:send, numbers:read, account:read, etc.); Privy sessions bypass scope checks. See /docs/api-reference/api-keys for the full scope catalogue.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Your phone number to renew (E.164)
Response Body
application/json
application/json
curl -X POST "https://payphone.wtf/api/v1/numbers/mine/renew" \ -H "Content-Type: application/json" \ -d '{ "phoneNumber": "string" }'{
"success": true,
"provider": "string",
"phoneNumber": "string",
"periodStart": "string",
"periodEnd": "string",
"textsIncluded": 0
}{
"x402Version": 2,
"accepts": [
{
"scheme": "exact",
"network": "eip155:8453",
"amount": "100000",
"payTo": "string"
}
]
}Buy Phone Line (International) POST
Buy an exclusive international phone line. $100 activation includes the first month and 10,000 free texts. Renews at $60/mo with 5,000 free texts per month. Full send and receive SMS. Manage from the dashboard with a Privy session.
Send SMS (A La Carte) POST
Send a one-off SMS to any phone worldwide. Omit `from` (or set `from: "pool"`) to use Dial's shared pool ($0.05/msg, outbound-only). Set `from` to your leased E.164 to send from your owned line (two-way, quota/credits). Pool sender line is chosen server-side and cannot be pinned per message.