Rentals

Re-rent an expired LTR number

Purchases a fresh rental period on the same phone number at the current re-rent price. Only call when re_rent_available: true on the rental resource.

No request body. Idempotency-Key is optional but recommended to guard against network retries triggering a double charge.

410 semantics

A 410 RE_RENT_NOT_AVAILABLE response means the number has been permanently released. Stop retrying; re_rent_available will be false on subsequent fetches. Offer the user a fresh rental via POST /v1/rentals instead.

post/rentals/{id}/re_rent

Request

  • Base URL: https://dashboard.voidmob.com/api/v1
  • URL: https://dashboard.voidmob.com/api/v1/rentals/{id}/re_rent
  • Auth: HTTP bearer

Path parameters

idstring required

Opaque long-term rental identifier.

Example:ren_01HXYZ123ABC

Long-term rental identifier (ren_ prefix).

Headers

Idempotency-Keystring required
Example:7c4f08c2-2a4f-4c8e-a1d2-9c2b9c8f7e10

Client-supplied key (any string, up to 255 chars) that scopes idempotent replay for write requests. Required on every POST, PATCH, and DELETE. Replays with the same key + same body return the cached response; same key with a different body returns IDEMPOTENCY_CONFLICT. Headers are case-insensitive; both Idempotency-Key and idempotency-key work.

Response

Re-rent succeeded. Returns the updated rental resource with the new expires_at and paid_until. status transitions back to active.

successtrue required

Example response

{
  "data": {
    "id": "ren_01HXYZ123ABC",
    "display_id": "SMS7K4P2N",
    "phone_number": "+15551234567",
    "service_id": "svc_telegram",
    "service_name": "Telegram",
    "country": "us",
    "duration": "7D",
    "charged_price_cents": 2500,
    "next_renewal_price_cents": 2500,
    "payment_due": {
      "amount_cents": 1499
    },
    "re_rent_available": true,
    "re_rent_price_cents": 2500,
    "messages": [
      {
        "id": "msg_01HXYZ123ABC",
        "code": "123456",
        "text": "Your verification code is 123456."
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.