Skip to main content

Allowed FOC Dates

Background​

The firm order commitment (FOC) date is the date that the losing carrier agrees to release the phone numbers to the winning carrier. In other words, it's the date that the port will actually take place on.

When creating a port order, you can request a specific FOC date that you would like your order to port on. This is specified in the ”foc_datetime_requested” attribute. While Telnyx will make every effort to port your order on your requested FOC date, we cannot guarantee that we will be able to match that requested date.

Once Telnyx receives FOC confirmation for your order, the order will transition into a foc-date-confirmed status and the ”foc_datetime_actual” attribute on the port order will be updated to reflect the actual FOC date.

Requesting a FOC date​

You can issue the following command to view the possible FOC dates of your port order.

Request:

curl --location --request GET 'https://api.telnyx.com/v2/porting_orders/{{id}}/allowed_foc_windows' \
--header 'Authorization: Bearer [REDACTED}'

Response (shortened for brevity):
{
    "data": [
        {
            "end_time": "2022-12-21T23:00:00Z",
            "ended_at": "2022-12-21T23:00:00Z",
            "record_type": "allowed_foc_window",
            "start_time": "2022-12-21T15:00:00Z",
            "started_at": "2022-12-21T15:00:00Z"
        },
        {
            "end_time": "2022-12-22T23:00:00Z",
            "ended_at": "2022-12-22T23:00:00Z",
            "record_type": "allowed_foc_window",
            "start_time": "2022-12-22T15:00:00Z",
            "started_at": "2022-12-22T15:00:00Z"
        },
        {
            "end_time": "2022-12-23T23:00:00Z",
            "ended_at": "2022-12-23T23:00:00Z",
            "record_type": "allowed_foc_window",
            "start_time": "2022-12-23T15:00:00Z",
            "started_at": "2022-12-23T15:00:00Z"
        },
…
}

Note: After pasting the above content, Kindly check and remove any new line added

The response will show a list of acceptable dates, as well as a range of times for those dates. If we take a closer look at an individual object (see below):

{
   "end_time":"2022-12-21T23:00:00Z",
   "ended_at":"2022-12-21T23:00:00Z",
   "record_type":"allowed_foc_window",
   "start_time":"2022-12-21T15:00:00Z",
   "started_at":"2022-12-21T15:00:00Z"
}

Note: After pasting the above content, Kindly check and remove any new line added

This object is indicating that if you wanted to port on 2022-12-21, you would have to specify a time between 15:00 - 23:00 UTC.

After viewing the allowable FOC dates, let's say that you want to request a FOC date of 2022-12-21T15:00:00Z. To update your port order, you can make the following request:

Request:

​​curl --location --request PATCH 'https://api.telnyx.com/v2/porting_orders/{{id}}' \
--header 'Authorization: Bearer [REDACTED]' \
--header 'Content-Type: application/json' \
--data-raw '{
    "activation_settings": {
        "foc_datetime_requested": "2022-12-21T15:00:00Z"
    }
}'

Response (shortened for brevity):

{
    "data": {
        "activation_settings": {
            "activation_status": null,
            "activation_type": "scheduled",
            "fast_port_eligible": true,
            "foc_datetime_actual": null,
            "foc_datetime_requested": "2022-12-21T15:00:00Z"
        }
…
}

Note: After pasting the above content, Kindly check and remove any new line added

On this page​