Phone Numbers (Unlimited)

Renew an existing phone number

Extend the rental period for an existing phone number. For custom time extensions that don't match these presets (like 2 weeks), you would make multiple API requests with the appropriate preset. For example, extending for 2 weeks would require submitting the oneWeek API request twice. Each extension request incrementally adds to the existing rental time period rather than resetting or replacing it.

post/renew

Request

  • Base URL: https://api.quackr.io
  • URL: https://api.quackr.io/renew
  • Auth: API key in header x-api-key

Request body

duration'halfDay' | 'oneDay' | 'oneWeek' | 'oneMonth' | 'sixMonths' | 'twelveMonths' required
phoneNumberstring required
localestring

Optional locale override. Useful when countries share the same mobile prefix (e.g. US and CA both use +1).

autoRenewboolean

Automatically renew the number before it expires, using the same duration.

Example request

{
  "duration": "oneWeek",
  "phoneNumber": "447366085728",
  "locale": "CA"
}

Response

Successfully renewed phone number

phoneNumbersstring[]
idstring
rentalEndDatenumber
pricenumber float
localestring
orderIdstring

The renewal's order number. Each renewal is its own order, in the same format as a purchase.

successboolean

Example response

{
  "phoneNumbers": [
    "447366085728"
  ],
  "id": "447366085728",
  "rentalEndDate": 1733918884113,
  "price": 12.99,
  "locale": "UK",
  "orderId": "QK-7K3M9P2X",
  "success": true
}

Changes

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