Send SMS (A La Carte)

Send a one-off SMS from Dial's shared number pool to any phone worldwide. No line purchase required — just $0.05 per message. Sent from one of Dial's reserved pool numbers. Inbound SMS is not supported on pool numbers.

Authorization

x402

X-PAYMENT<token>

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

to*string

Recipient phone number (E.164)

message*string

SMS message body (max 900 chars)

Response Body

`application/json`

curl -X POST "https://x402.dial.wtf/api/v1/sms/send" \  -H "Content-Type: application/json" \  -d '{    "to": "string",    "message": "string"  }'

{
  "success": true,
  "provider": "string",
  "messageId": "string"
}

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "100000",
      "payTo": "string"
    }
  ]
}

Authorization

Request Body

Response Body

200application/json

402application/json

`application/json`

`application/json`