Allowed FOC Dates

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.

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

Note

Don't forget to update YOUR_API_KEY here.

Request:

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

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"
        },
…
}

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"
}

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"
        }
…
}