---
title: "Renew an existing phone number"
method: POST
path: "/renew"
tags: ["Phone Numbers (Unlimited)"]
---

# Renew an existing phone number

`POST /renew`

## Request

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

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.

## Request body

- object
  - `duration` 'halfDay' | 'oneDay' | 'oneWeek' | 'oneMonth' | 'sixMonths' | 'twelveMonths', required
  - `phoneNumber` string, required
  - `locale` string: Optional locale override. Useful when countries share the same mobile prefix (e.g. US and CA both use +1).
  - `autoRenew` boolean: Automatically renew the number before it expires, using the same duration.

## Response `200`

Successfully renewed phone number

- object
  - `phoneNumbers` string[]
  - `id` string
  - `rentalEndDate` number
  - `price` number, float
  - `locale` string
  - `orderId` string: The renewal's order number. Each renewal is its own order, in the same format as a purchase.
  - `success` boolean

## Other responses

- `400`: Invalid request parameters

---

[API](https://skmtc.dev/quackr/apis/quackr-api.md) · [All operations](https://skmtc.dev/quackr/apis/quackr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/quackr/apis/quackr-api/revisions/9b7240306750?raw)