Telnyx

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const portingOrder = await client.portingOrders.update('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');

console.log(portingOrder.data);

{
  "data": {
    "activation_settings": {
      "activation_status": null,
      "fast_port_eligible": true,
      "foc_datetime_actual": null,
      "foc_datetime_requested": "2022-04-08T15:00:00Z"
    },
    "created_at": "2022-03-24T14:22:28Z",
    "customer_reference": "Test1234",
    "customer_group_reference": "Group-789",
    "description": "FP Telnyx",
    "documents": {
      "loa": null,
      "invoice": null
    },
    "end_user": {
      "admin": {
        "account_number": "123abc",
        "auth_person_name": "Porter McPortersen II",
        "billing_phone_number": "+13035551234",
        "business_identifier": "abc123",
        "entity_name": "Porter McPortersen",
        "pin_passcode": "1234",
        "tax_identifier": "1234abcd"
      },
      "location": {
        "administrative_area": "TX",
        "country_code": "US",
        "extended_address": "14th Floor",
        "locality": "Austin",
        "postal_code": "78701",
        "street_address": "600 Congress Avenue"
      }
    },
    "id": "eef10fb8-f3df-4c67-97c5-e18179723222",
    "misc": {
      "new_billing_phone_number": null,
      "remaining_numbers_action": null,
      "type": "full"
    },
    "old_service_provider_ocn": "Unreal Communications",
    "parent_support_key": null,
    "phone_number_configuration": {
      "billing_group_id": null,
      "connection_id": "1752379429071357070",
      "emergency_address_id": null,
      "messaging_profile_id": null,
      "tags": []
    },
    "phone_number_type": "local",
    "porting_phone_numbers_count": 1,
    "record_type": "porting_order",
    "requirements": [],
    "requirements_met": false,
    "status": {
      "details": [],
      "value": "draft"
    },
    "support_key": null,
    "updated_at": "2022-03-24T14:26:53Z",
    "user_feedback": {
      "user_comment": null,
      "user_rating": null
    },
    "messaging": {
      "messaging_capable": true,
      "enable_messaging": true,
      "messaging_port_status": "pending",
      "messaging_port_completed": false
    },
    "user_id": "40d68ba2-0847-4df2-be9c-b0e0cb673e75",
    "webhook_url": "https://example.com/porting_webhooks"
  },
  "meta": {
    "phone_numbers_url": "/v2/porting_phone_numbers?filter[porting_order_id]=eef10fb8-f3df-4c67-97c5-e18179723222"
  }
}

PATCH

porting_orders

{id}

JavaScript

import Telnyx from 'telnyx';

const client = new Telnyx({
  apiKey: 'My API Key',
});

const portingOrder = await client.portingOrders.update('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');

console.log(portingOrder.data);

{
  "data": {
    "activation_settings": {
      "activation_status": null,
      "fast_port_eligible": true,
      "foc_datetime_actual": null,
      "foc_datetime_requested": "2022-04-08T15:00:00Z"
    },
    "created_at": "2022-03-24T14:22:28Z",
    "customer_reference": "Test1234",
    "customer_group_reference": "Group-789",
    "description": "FP Telnyx",
    "documents": {
      "loa": null,
      "invoice": null
    },
    "end_user": {
      "admin": {
        "account_number": "123abc",
        "auth_person_name": "Porter McPortersen II",
        "billing_phone_number": "+13035551234",
        "business_identifier": "abc123",
        "entity_name": "Porter McPortersen",
        "pin_passcode": "1234",
        "tax_identifier": "1234abcd"
      },
      "location": {
        "administrative_area": "TX",
        "country_code": "US",
        "extended_address": "14th Floor",
        "locality": "Austin",
        "postal_code": "78701",
        "street_address": "600 Congress Avenue"
      }
    },
    "id": "eef10fb8-f3df-4c67-97c5-e18179723222",
    "misc": {
      "new_billing_phone_number": null,
      "remaining_numbers_action": null,
      "type": "full"
    },
    "old_service_provider_ocn": "Unreal Communications",
    "parent_support_key": null,
    "phone_number_configuration": {
      "billing_group_id": null,
      "connection_id": "1752379429071357070",
      "emergency_address_id": null,
      "messaging_profile_id": null,
      "tags": []
    },
    "phone_number_type": "local",
    "porting_phone_numbers_count": 1,
    "record_type": "porting_order",
    "requirements": [],
    "requirements_met": false,
    "status": {
      "details": [],
      "value": "draft"
    },
    "support_key": null,
    "updated_at": "2022-03-24T14:26:53Z",
    "user_feedback": {
      "user_comment": null,
      "user_rating": null
    },
    "messaging": {
      "messaging_capable": true,
      "enable_messaging": true,
      "messaging_port_status": "pending",
      "messaging_port_completed": false
    },
    "user_id": "40d68ba2-0847-4df2-be9c-b0e0cb673e75",
    "webhook_url": "https://example.com/porting_webhooks"
  },
  "meta": {
    "phone_numbers_url": "/v2/porting_phone_numbers?filter[porting_order_id]=eef10fb8-f3df-4c67-97c5-e18179723222"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string<uuid>

required

Porting Order id

Body

application/json

misc

object

Show child attributes

misc.type

enum<string>

A port can be either 'full' or 'partial'. When type is 'full' the other attributes should be omitted.

Available options:

full,

partial

Example:

"full"

misc.remaining_numbers_action

enum<string>

Remaining numbers can be either kept with their current service provider or disconnected. 'new_billing_telephone_number' is required when 'remaining_numbers_action' is 'keep'.

Available options:

keep,

disconnect

Example:

"disconnect"

misc.new_billing_phone_number

string

New billing phone number for the remaining numbers. Used in case the current billing phone number is being ported to Telnyx. This will be set on your account with your current service provider and should be one of the numbers remaining on that account.

end_user

object

Show child attributes

end_user.admin

object

Show child attributes

end_user.admin.entity_name

string

Person Name or Company name requesting the port

Example:

"Porter McPortersen"

end_user.admin.auth_person_name

string

Name of person authorizing the porting order

Example:

"Porter McPortersen II"

end_user.admin.billing_phone_number

string

Billing phone number associated with these phone numbers

Example:

13035551234

end_user.admin.account_number

string

The authorized person's account number with the current service provider

Example:

"123abc"

end_user.admin.tax_identifier

string

European tax identification number. Applicable only in the European Union

Example:

"1234abcd"

end_user.admin.pin_passcode

string

PIN/passcode possibly required by the old service provider for extra verification

Example:

1234

end_user.admin.business_identifier

string

European business identification number. Applicable only in the European Union

Example:

"abc123"

end_user.location

object

Show child attributes

end_user.location.street_address

string

First line of billing address

Example:

"600 Congress Avenue"

end_user.location.extended_address

string

Second line of billing address

Example:

"14th Floor"

end_user.location.locality

string

City or municipality of billing address

Example:

"Austin"

end_user.location.administrative_area

string

State, province, or similar of billing address

Example:

"TX"

end_user.location.postal_code

string

Postal Code of billing address

Example:

"78701"

end_user.location.country_code

string

ISO3166-1 alpha-2 country code of billing address

Example:

"US"

documents

object

Can be specified directly or via the requirement_group_id parameter.

Show child attributes

documents.loa

string<uuid>

Returned ID of the submitted LOA via the Documents endpoint

Example:

"64ffb720-04c7-455b-92d6-20fcca92e935"

documents.invoice

string<uuid>

Returned ID of the submitted Invoice via the Documents endpoint

Example:

"ce74b771-d23d-4960-81ec-8741b3862146"

activation_settings

object

Show child attributes

activation_settings.foc_datetime_requested

string<date-time>

ISO 8601 formatted Date/Time requested for the FOC date

Example:

"2021-03-19T10:07:15.527Z"

phone_number_configuration

object

Show child attributes

phone_number_configuration.billing_group_id

string

identifies the billing group to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

phone_number_configuration.connection_id

string

identifies the connection to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

phone_number_configuration.messaging_profile_id

string

identifies the messaging profile to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f901"

phone_number_configuration.emergency_address_id

string

identifies the emergency address to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

phone_number_configuration.tags

string[]

Tag to set on the numbers when ported

Example:

["abc", "123"]

requirement_group_id

string<uuid>

If present, we will read the current values from the specified Requirement Group into the Documents and Requirements for this Porting Order. Note that any future changes in the Requirement Group would have no impact on this Porting Order. We will return an error if a specified Requirement Group conflicts with documents or requirements in the same request.

Example:

"DE748D99-06FA-4D90-9F9A-F4B62696BADA"

requirements

object[]

List of requirements for porting numbers.

Show child attributes

requirements.field_value

string

required

identifies the document or provides the text value that satisfies this requirement

Example:

"9787fb5f-cbe5-4de4-b765-3303774ee9fe"

requirements.requirement_type_id

string

required

Identifies the requirement type that the field_value fulfills

Example:

"59b0762a-b274-4f76-ac32-4d5cf0272e66"

user_feedback

object

Show child attributes

user_feedback.user_rating

integer

Once an order is ported, cancellation is requested or the request is cancelled, the user may rate their experience

Example:

5

user_feedback.user_comment

string

A comment related to the customer rating.

Example:

"I loved my experience porting numbers with Telnyx"

webhook_url

string<uri>

customer_reference

string

customer_group_reference

string

messaging

object

Show child attributes

messaging.enable_messaging

boolean

Indicates whether Telnyx will port messaging capabilities from the losing carrier. If false, any messaging capabilities will stay with their current provider.

Example:

true

Response

Successful response

data

object

Show child attributes

data.id

string<uuid>

Uniquely identifies this porting order

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

data.customer_reference

string

A customer-specified reference number for customer bookkeeping purposes

Example:

"Acct 123abc"

data.customer_group_reference

string

A customer-specified group reference for customer bookkeeping purposes

Example:

"Group-456"

data.created_at

string<date-time>

ISO 8601 formatted date indicating when the resource was created.

Example:

"2021-03-19T10:07:15.527Z"

data.updated_at

string<date-time>

ISO 8601 formatted date indicating when the resource was created.

Example:

"2021-03-19T10:07:15.527Z"

data.status

object

Porting order status

Show child attributes

data.status.details

object[]

A list of 0 or more details about this porting order's status

Show child attributes

data.status.details.code

enum<string>

Identifier of an exception type

Available options:

ACCOUNT_NUMBER_MISMATCH,

AUTH_PERSON_MISMATCH,

BTN_ATN_MISMATCH,

ENTITY_NAME_MISMATCH,

FOC_EXPIRED,

FOC_REJECTED,

LOCATION_MISMATCH,

LSR_PENDING,

MAIN_BTN_PORTING,

OSP_IRRESPONSIVE,

OTHER,

PASSCODE_PIN_INVALID,

PHONE_NUMBER_HAS_SPECIAL_FEATURE,

PHONE_NUMBER_MISMATCH,

PHONE_NUMBER_NOT_PORTABLE,

PORT_TYPE_INCORRECT,

PORTING_ORDER_SPLIT_REQUIRED,

POSTAL_CODE_MISMATCH,

RATE_CENTER_NOT_PORTABLE,

SV_CONFLICT,

SV_UNKNOWN_FAILURE

Example:

"ENTITY_NAME_MISMATCH"

data.status.details.description

string

Description of an exception type

Example:

"Entity name does not match that on the CSR"

data.status.value

enum<string>

The current status of the porting order

Available options:

draft,

in-process,

submitted,

exception,

foc-date-confirmed,

ported,

cancelled,

cancel-pending

Example:

"ported"

data.support_key

string

A key to reference this porting order when contacting Telnyx customer support. This information is not available in draft porting orders.

Example:

"sr_123abc"

data.parent_support_key

string

A key to reference for the porting order group when contacting Telnyx customer support. This information is not available for porting orders in draft state

Example:

"pr_123abc"

data.porting_phone_numbers_count

integer

Count of phone numbers associated with this porting order

Example:

1

data.old_service_provider_ocn

string

Identifies the old service provider

Example:

"Unreal Communications"

data.documents

object

Can be specified directly or via the requirement_group_id parameter.

Show child attributes

data.documents.loa

string<uuid>

Returned ID of the submitted LOA via the Documents endpoint

Example:

"64ffb720-04c7-455b-92d6-20fcca92e935"

data.documents.invoice

string<uuid>

Returned ID of the submitted Invoice via the Documents endpoint

Example:

"ce74b771-d23d-4960-81ec-8741b3862146"

data.misc

object

Show child attributes

data.misc.type

enum<string>

A port can be either 'full' or 'partial'. When type is 'full' the other attributes should be omitted.

Available options:

full,

partial

Example:

"full"

data.misc.remaining_numbers_action

enum<string>

Remaining numbers can be either kept with their current service provider or disconnected. 'new_billing_telephone_number' is required when 'remaining_numbers_action' is 'keep'.

Available options:

keep,

disconnect

Example:

"disconnect"

data.misc.new_billing_phone_number

string

data.end_user

object

Show child attributes

data.end_user.admin

object

Show child attributes

data.end_user.admin.entity_name

string

Person Name or Company name requesting the port

Example:

"Porter McPortersen"

data.end_user.admin.auth_person_name

string

Name of person authorizing the porting order

Example:

"Porter McPortersen II"

data.end_user.admin.billing_phone_number

string

Billing phone number associated with these phone numbers

Example:

13035551234

data.end_user.admin.account_number

string

The authorized person's account number with the current service provider

Example:

"123abc"

data.end_user.admin.tax_identifier

string

European tax identification number. Applicable only in the European Union

Example:

"1234abcd"

data.end_user.admin.pin_passcode

string

PIN/passcode possibly required by the old service provider for extra verification

Example:

1234

data.end_user.admin.business_identifier

string

European business identification number. Applicable only in the European Union

Example:

"abc123"

data.end_user.location

object

Show child attributes

data.end_user.location.street_address

string

First line of billing address

Example:

"600 Congress Avenue"

data.end_user.location.extended_address

string

Second line of billing address

Example:

"14th Floor"

data.end_user.location.locality

string

City or municipality of billing address

Example:

"Austin"

data.end_user.location.administrative_area

string

State, province, or similar of billing address

Example:

"TX"

data.end_user.location.postal_code

string

Postal Code of billing address

Example:

"78701"

data.end_user.location.country_code

string

ISO3166-1 alpha-2 country code of billing address

Example:

"US"

data.activation_settings

object

Show child attributes

data.activation_settings.foc_datetime_requested

string<date-time>

ISO 8601 formatted Date/Time requested for the FOC date

Example:

"2021-03-19T10:07:15.527Z"

data.activation_settings.foc_datetime_actual

string<date-time>

ISO 8601 formatted Date/Time of the FOC date

Example:

"2021-03-19T10:07:15.527Z"

data.activation_settings.fast_port_eligible

boolean

Indicates whether this porting order is eligible for FastPort

Example:

true

data.activation_settings.activation_status

enum<string>

Activation status

Available options:

New,

Pending,

Conflict,

Cancel Pending,

Failed,

Concurred,

Activate RDY,

Disconnect Pending,

Concurrence Sent,

Old,

Sending,

Active,

Cancelled

Example:

"Active"

data.phone_number_configuration

object

Show child attributes

data.phone_number_configuration.billing_group_id

string

identifies the billing group to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

data.phone_number_configuration.connection_id

string

identifies the connection to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

data.phone_number_configuration.messaging_profile_id

string

identifies the messaging profile to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f901"

data.phone_number_configuration.emergency_address_id

string

identifies the emergency address to set on the numbers when ported

Example:

"f1486bae-f067-460c-ad43-73a92848f902"

data.phone_number_configuration.tags

string[]

Tag to set on the numbers when ported

Example:

["abc", "123"]

data.phone_number_type

enum<string>

The type of the phone number

Available options:

landline,

local,

mobile,

national,

shared_cost,

toll_free

Example:

"local"

data.description

string

A description of the porting order

Example:

"FP Telnyx"

data.requirements

object[]

List of documentation requirements for porting numbers. Can be set directly or via the requirement_group_id parameter.

Show child attributes

data.requirements.field_type

enum<string>

Type of value expected on field_value field

Available options:

document

Example:

"document"

data.requirements.field_value

string

identifies the document that satisfies this requirement

Example:

"9787fb5f-cbe5-4de4-b765-3303774ee9fe"

data.requirements.requirement_type_id

string

Identifies the requirement type that meets this requirement

Example:

"59b0762a-b274-4f76-ac32-4d5cf0272e66"

data.requirements.record_type

string

Identifies the type of the resource.

Example:

"porting_requirement"

data.requirements_met

boolean

Is true when the required documentation is met

Example:

false

data.user_feedback

object

Show child attributes

data.user_feedback.user_rating

integer

Once an order is ported, cancellation is requested or the request is cancelled, the user may rate their experience

Example:

5

data.user_feedback.user_comment

string

A comment related to the customer rating.

Example:

"I loved my experience porting numbers with Telnyx"

data.user_id

string<uuid>

Identifies the user (or organization) who requested the porting order

Example:

"40d68ba2-0847-4df2-be9c-b0e0cb673e75"

data.webhook_url

string<uri>

Example:

"https://example.com/porting_webhooks"

data.record_type

string

Identifies the type of the resource.

Example:

"porting_order"

data.messaging

object

Information about messaging porting process.

Show child attributes

data.messaging.messaging_capable

boolean

Indicates whether the porting order can also port messaging capabilities.

Example:

true

data.messaging.enable_messaging

boolean

Indicates whether Telnyx will port messaging capabilities from the losing carrier. If false, any messaging capabilities will stay with their current provider.

Example:

true

data.messaging.messaging_port_status

enum<string>

The current status of the messaging porting.

Available options:

not_applicable,

pending,

activating,

exception,

canceled,

partial_port_complete,

ported

Example:

"pending"

data.messaging.messaging_port_completed

boolean

Indicates whether the messaging porting has been completed.

Example:

false

data.additional_steps

enum<string>[]

For specific porting orders, we may require additional steps to be taken before submitting the porting order.

Available options:

associated_phone_numbers,

phone_number_verification_codes

OAuth Discovery

IP Addresses

IP Ranges

SIM Cards

Addresses

Advanced Number Orders

Assistants

Audio

Chat

Clusters

Conversations

Embeddings

Fine Tuning

Integrations

MCP Servers

Audit Logs

Authentication Providers

Phone Number Search

Billing

Billing Groups

Brands

SIM Card Actions

Bundles

User Bundles

Call Control Applications

Debugging

Call Commands

Call Information

Campaign

Voice Channels

API Reference

Phone Number Orders

Conference Commands

Connections

Country Coverage

Credential Connections

Call Recordings

Customer Service Record

Detail Records

Dialogflow Integration

Documents

Dynamic Emergency Addresses

Dynamic Emergency Endpoints

Enum

External Connections

Programmable Fax Applications

Programmable Fax Commands

FQDN Connections

FQDNs

Global IPs

Inexplicit Number Orders

Integration Secrets

Inventory Level

IP Connections

IPs

Reports

MDR Detailed Reports

Speech to Text Batch Reports

CDR Reports

MDR Usage Reports

Telco Data Usage Reports

Speech to text Usage Reports

CDR Usage Reports

Managed Accounts

Media Storage API

Messages

RCS messaging

Messaging Hosted Number

Number Configurations

Advanced OptIn/OptOut

Messaging Profiles

Messaging Tollfree Verification

Messaging URL Domains

Mobile Network Operators

Push Credentials

Coverage

Networks

Notifications

Phone Number Block Orders

Number Lookup