Our developer docs provide full information to Porting phone numbers via API with Telnyx. You can find all of the information needed for porting via API in our Developer docs here.

Different statuses and what they mean:

"in-process"
This is the status of a port request once it has been successfully submitted to Telnyx. When a port request is "in-process" this means that we have received the port request and it is currently waiting to be submitted to the losing provider. Generally, this status will change after a few hours (during business hours).

"submitted",

This is the status of a port request once it has been successfully submitted to the losing provider. When a port request is "submitted" this means that we are awaiting the losing providers response. Generally, we will update the port request within 48-36 business hours once the losing provider has responded to us.

"exception"

This is the status of a port request once the port request has been deemed invalid by the losing provider. When a port request is "exception" this means that the losing provider has responded with a rejection. Generally, this means that something that was submitted to Telnyx within the port request differs from the information that is on record with the losing carrier.
For a full list of rejection reason, please see Porting Error Messages

"foc-date-confirmed",

This is the status of a port request once the port request has been confirmed by the losing provider. When a port request is "foc-date-confirmed" this means that the losing provider has provided a port confirmation date. Generally, this means that the port is confirmed and it will port at the specified date/time as per the "foc_date" field.

"ported"

This is the status of a port request once the port request has been confirmed as ported away from the losing provider and now with Telnyx. When a port request is "ported" this means that calls should now be hitting Telnyx. Generally, this means that the port is fully complete and calls will now route via Telnyx.

"cancel-pending"
This is the status of a port request once Telnyx receive the cancellation request for the port request. When a port request is "cancel-pending" this means that Telnyx now need to inform the losing carrier of the cancellation request. Generally, this means that the port will be confirmed as ported once we receive confirmation from the losing carrier that they have cancelled the original port request from Telnyx. Depending upon the losing carrier, this can take up to 48 hours.

"cancelled"

This is the status of a port request once Telnyx receive the confirmation of the cancellation of the port request from the losing carrier. When a port request is "cancelled" this means that Telnyx have received confirmation from the losing carrier. Generally, this means that the port is confirmed as cancelled on the losing carrier's side and they will not remove the number(s) from routing on/after the requested/confirmed porting date.


Did this answer your question?