Numbers that stay yours, for as long as you need

Clear rules for the life of a number

• Provisioning: the term price is debited when the number is assigned to your account.
• Renewal window: with auto-renew on, the next term is collected from your wallet 24 hours before the current term ends.
• Low balance: if the wallet cannot cover the renewal, we email a reminder and keep trying until the term ends.
• Unpaid renewal: if the renewal still cannot be collected when the term ends, the number is released and you are notified.
• Manual release: release any time from the dashboard. Prepaid term fees for a provisioned number are not refunded.
• Turn off auto-renew to let a number lapse at the end of its paid term.

Released numbers return to the carrier pool and cannot be guaranteed for re-rental. See the Refund Policy.

Every inbound SMS as an event

Register an endpoint in the developer console and subscribe to number.sms_received. Payloads are signed like every other event.

X-OTPRoute-Event: number.sms_received
X-OTPRoute-Signature: t=1793318400,v1=9b04e1…

{
  "id": "evt_3c81aa07f4d95e20b16c",
  "type": "number.sms_received",
  "created": 1793318400,
  "data": {
    "id": "msg_51e0c9b2a7d4f3168e02",
    "number_id": "num_7a2d90c1e4b85f3602ad",
    "to": "+14155550143",
    "from": "+15555550100",
    "text": "Your verification code is 731204.",
    "received_at": 1793318400
  }
}