List released phone numbers. Released numbers may be purchased again with 2 weeks of being released. Released numbers may be removed from released list after 2 weeks.
GET /numbers/released
Authorizations
Section titled “Authorizations ”Responses
Section titled “ Responses ”Successful response
object
Represents a phone number in the account
object
E.164
ISO timestamp when the number was registered
ISO 3166-1 alpha-2 country code
E.g. local, toll_free
Active or released
YYYY-MM-DD next monthly rent charge
Monthly cost in USD
US 10DLC readiness derived from stored campaign assignment
ISO timestamp when the number was released (released numbers only)
Bad Request - validation errors, invalid input
Standard error response for API errors.
object
Unique tracking ID for the request.
Structured error details for API error responses.
object
Machine-readable error code.
Human-readable error message.
Actionable hint for fixing the error.
Provider that caused the error (e.g. telnyx, ses).
Provider-specific error code.
Unauthorized
Payment Required - usage limits exceeded
Standard error response for API errors.
object
Unique tracking ID for the request.
Structured error details for API error responses.
object
Machine-readable error code.
Human-readable error message.
Actionable hint for fixing the error.
Provider that caused the error (e.g. telnyx, ses).
Provider-specific error code.
Internal Server Error
Bad Gateway - provider error
Standard error response for API errors.
object
Unique tracking ID for the request.
Structured error details for API error responses.
object
Machine-readable error code.
Human-readable error message.
Actionable hint for fixing the error.
Provider that caused the error (e.g. telnyx, ses).
Provider-specific error code.