Skip to main content

Edit a sub request

PUT 
/origination/porting/port_requests/:port_request_id/sub_requests/:id

Edits the details of an existing sub request.

Request

Path Parameters

    port_request_id stringrequired

    Port Request id

    id stringrequired

    Sub Request id

Body

required

Updated sub request details

    foc_date_requested_by_user stringrequired

    ISO 8601 formatted Date/Time requested for the FOC date

    person_or_company_name string

    Person Name or Company name requesting the port

    auth_person_name stringrequired

    Name of person authorizing the port request

    billing_phone_number stringrequired

    Billing phone number associated with these phone numbers

    street_address stringrequired

    First line of billing address

    extended_address string

    Second line of billing address

    locality stringrequired

    City of billing address

    administrative_area stringrequired

    Two character state abbreviation of billing address

    postal_code stringrequired

    Postal Code of billing address

    country_code stringrequired

    ISO3166-1 alpha-2 country code of billing address

    default_connection_id stringrequired

    Identifies the connection to set on the numbers when the port completes

    porting_option

    object

    Options for the processing of numbers with your current service provider.

    type stringrequired

    Possible values: [partial, full]

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

    remaining_numbers_action string

    Possible values: [keep, disconnect]

    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'.

    new_billing_phone_number string

    New billing telephone numbers for the remaining numbers. This will be set on your account with your current service provider and should be one of the numbers remaining on that account.

    Options for the processing of numbers with your current service provider.

    pin_passcode string

    PIN/passcode for accounts that have wireless type numbers

    account_number string

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

    tax_identifier string

    European tax identification number. Applicable only in the European Union

    business_identifier string

    European business identification number. Applicable only in the European Union

    customer_rating integer

    Once a sub request is ported, cancellation is requested or the sub request is cancelled, the user may rate their experience.

    customer_rating_comment string

    A comment related to the customer rating

Responses

200: Sub Requests Response

401: Unauthorized

Request samples


curl -L -X PUT 'https://api.telnyx.com/origination/porting/port_requests/:port_request_id/sub_requests/:id' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-d '{
"foc_date_requested_by_user": "string",
"person_or_company_name": "string",
"auth_person_name": "string",
"billing_phone_number": "string",
"street_address": "string",
"extended_address": "string",
"locality": "string",
"administrative_area": "string",
"postal_code": "string",
"country_code": "string",
"default_connection_id": "string",
"porting_option": {
"type": "partial",
"remaining_numbers_action": "keep",
"new_billing_phone_number": "string"
},
"pin_passcode": "string",
"account_number": "string",
"tax_identifier": "string",
"business_identifier": "string",
"customer_rating": 0,
"customer_rating_comment": "string"
}'

Response samples


[
{
"id": "string",
"phone_numbers": [
{
"phone_number": "string",
"svtype": "string",
"carrier_name": "string",
"coverage_category": "nanp_generic",
"sub_request_id": "string",
"sub_request_status": "string",
"portability_status": "pending"
}
],
"foc_date": "string",
"status": "unassigned",
"support_key": "string",
"phone_number_count": 0,
"underlying_carrier_names": [
"string"
],
"foc_date_requested_by_user": "string",
"person_or_company_name": "string",
"auth_person_name": "string",
"billing_phone_number": "string",
"street_address": "string",
"extended_address": "string",
"locality": "string",
"administrative_area": "string",
"postal_code": "string",
"country_code": "string",
"created_at": "string",
"updated_at": "string",
"default_connection_id": "string",
"default_message_profile_id": "string",
"porting_option": {
"type": "partial",
"remaining_numbers_action": "keep",
"new_billing_phone_number": "string"
},
"pin_passcode": "string",
"account_number": "string",
"description": "string",
"tax_identifier": "string",
"business_identifier": "string",
"customer_rating": 0,
"customer_rating_comment": "string"
}
]