Skip to main content
Version: 1.0.16 · Status: Live · Published by: Telegent Platform Team
Now live in production. The v1.0.16 features below are live.
This release changes how number cancellation works: cancellation is now immediate on the carrier and goes through a two-stage, auth-code-confirmed flow. Cancelled numbers enter a 30-day recovery window before they are permanently released.

Breaking

  • Cancellation is now a two-stage flow. Cancel a number with POST /v1.0/numbers/cancel-order-request (returns an AuthCode + consent statement), then POST /v1.0/numbers/cancel-order-submit (confirms and cancels). Cancellation is immediate on the carrier.
  • Cancel removed from POST /v1.0/numbers/status. Sending "StatusChange": "cancel" now returns 400 — Cancel has moved to POST /numbers/cancel-order-request.
  • No future-dated cancellations. Cancellation happens when it is submitted; there is no effective date.

New

Numbers - Cancel Order Request — stage 1: validate numbers and receive a single-use AuthCode (5-minute expiry) plus the consent statement. No numbers are cancelled yet.
  • POST /v1.0/numbers/cancel-order-request
Numbers - Cancel Order Submit — stage 2: submit the OrderId + AuthCode to cancel immediately. Returns Complete / Failed with NumbersChange and FailedChange.
  • POST /v1.0/numbers/cancel-order-submit
  • New guide: Cancelling Numbers — the full two-stage flow, AuthCode rules, consent statement, the 30-day window, and error reference, with sample payloads.

Enhanced

  • Number lifecycle & 30-day recovery window. A successful cancellation sets the number to Cancelled - Pending Delete for 30 days (reactivatable for a $5 recovery fee per number), after which a nightly job flips it to Cancelled (permanently released). Filter with GET /v1.0/numbers/inventory?Filter=Cancelled%20-%20Pending%20Delete.
  • Reactivate — 30-day / $5 model. POST /v1.0/numbers/reactivate now uses the 30-day recovery window (replacing the old 24-hour window), with a $5 recovery fee per number billed on a successful reactivation.

Questions about this release? Contact support@telegent.com.