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 anAuthCode+ consent statement), thenPOST /v1.0/numbers/cancel-order-submit(confirms and cancels). Cancellation is immediate on the carrier. Cancelremoved fromPOST /v1.0/numbers/status. Sending"StatusChange": "cancel"now returns400 — 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 (2 endpoints)
Numbers (2 endpoints)
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
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 Deletefor 30 days (reactivatable for a $5 recovery fee per number), after which a nightly job flips it toCancelled(permanently released). Filter withGET /v1.0/numbers/inventory?Filter=Cancelled%20-%20Pending%20Delete. - Reactivate — 30-day / $5 model.
POST /v1.0/numbers/reactivatenow 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.