---
title: "Renew the numbers"
method: POST
path: "/numbers/renew"
tags: ["Number"]
---

# Renew the numbers

`POST /numbers/renew`

Renew the specified numbers and return the updated number details.

## Request body

- object
  - `tm_renew` string, required — The timestamp for renewing the number.

## Response `200`

A list of renewed order numbers.

- NumberManagerNumber[]
  - `id` string, uuid — The unique identifier for the number.
  - `customer_id` string, uuid — The customer ID associated with the number. Returned from the `GET /customers` response.
  - `number` string — The phone number in E.164 format (normal) or +899 format (virtual).
  - `type` 'normal' | 'virtual' — The type of the number.
  - `call_flow_id` string, uuid — The unique identifier of the flow to execute for incoming calls. Returned from the `POST /flows` or `GET /flows` response.
  - `message_flow_id` string, uuid — The unique identifier of the flow to execute for incoming messages. Returned from the `POST /flows` or `GET /flows` response.
  - `name` string — The name of the number.
  - `detail` string — Additional details about the number.
  - `status` 'active' | 'deleted' — The status of the number.
  - `t38_enabled` boolean — Whether T38 is enabled for the number.
  - `emergency_enabled` boolean — Whether emergency services are enabled for the number.
  - `metadata` NumberManagerMetadata — Configuration flags for a number. Controls platform behavior such as RTP packet capture for debugging audio issues on this specific number. Updatable by CustomerAdmin or CustomerManager via `PUT /numbers/{id}/metadata`.
    - `rtp_debug` boolean — When set to `true`, RTPEngine captures RTP traffic as PCAP files for calls to this number. This flag is OR'd with the customer-level `rtp_debug` — if either is `true`, capture is enabled. Use this to debug audio quality issues on a specific number without enabling capture for all customer calls. Default is `false`. Enabling this increases storage usage — disable after debugging.
  - `tm_purchase` string, date-time — The timestamp of when the number was purchased.
  - `tm_renew` string, date-time — The timestamp of when the number was renewed.
  - `tm_create` string, date-time — The timestamp of when the number was created.
  - `tm_update` string, date-time — The timestamp of when the number was last updated.
  - `tm_delete` string, date-time — The timestamp of when the number was deleted.

## Other responses

- `400` — Invalid request (INVALID_ARGUMENT).
- `401` — Authentication required (UNAUTHENTICATED).
- `402` — Payment required (PAYMENT_REQUIRED).
- `403` — Insufficient permission (PERMISSION_DENIED).
- `500` — Internal error (INTERNAL).

---

[API](https://skmtc.net/voipbin/apis/voipbin-api.md) · [All operations](https://skmtc.net/voipbin/apis/voipbin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voipbin/voipbin-api/versions/79e779080bcc/schema)