Docs·Rentals
📞

Rentals

Hold a number for hours or days — receive multiple SMS, browse history, auto-renew at expiry.

When to rent

Rentals are for cases where you need the same number for more than one inbound SMS, or for a window longer than 60 minutes. Typical: long-term 2FA, multi-day signup/KYC flow, research bench. For single-code verifications, Activations are cheaper.

Create

curl -X POST https://api.eveses.com/api/account/orders \
  -H "Authorization: Bearer $EVESES_API_KEY" \
  -d '{"mode":"rent", "country":"ua", "service":"telegram", "duration_minutes": 1440}'

Available duration_minutes: 60, 240, 1440, 10080 (week), 43200 (month). The longer the window, the lower the per-hour cost.

Inbox

Every inbound SMS is stored:

curl https://api.eveses.com/api/account/orders/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e/sms \
  -H "Authorization: Bearer $EVESES_API_KEY"

Each message: text, sender, received_at. Webhook rent.sms_received pushes them in real time.

Auto-renew

curl -X POST https://api.eveses.com/api/account/orders/9a1f2c3d-4e5b-6a7c-8d9e-0f1a2b3c4d5e/auto-renew \
  -d '{"enabled": true}'

Turns on automatic renewal — the number is re-rented for another term the instant it expires, so you keep the same number with no gap. Send {"enabled": false} to turn it off.

Cancel

Cancel within the first 30 minutes for a full refund. After that, the rental runs to term — no partial refunds.