Allows to create a new port in request

POST /v1/Porting/PortIn

Allows to create a new port in request

application/json

Body

object object

Responses

  • 202 application/json

    Accepted

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    Hide response attributes Show response attributes object
    • port_in_request_sid string | null

      The SID of the Port In request. This is a unique identifier of the port in request.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^KW[0-9a-fA-F]{32}$.

    • url string(uri) | null

      The URL of this Port In request

    • account_sid string | null

      Account Sid or subaccount where the phone number(s) will be Ported

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

    • notification_emails array[string] | null

      Additional emails to send a copy of the signed LOA to.

    • target_port_in_date string(date) | null

      Target date to port the number. We cannot guarantee that this date will be honored by the other carriers, please work with Ops to get a confirmation of the firm order commitment (FOC) date. Expected format is ISO Local Date, example: ‘2011-12-03`. This date must be at least 7 days in the future for US ports and 10 days in the future for Japanese ports. We can't guarantee the exact date and time, as this depends on the losing carrier

    • target_port_in_time_range_start string | null

      The earliest time that the port should occur on the target port in date. Expected format is ISO Offset Time, example: ‘10:15:00-08:00'. We can't guarantee the exact date and time, as this depends on the losing carrier

    • target_port_in_time_range_end string | null

      The latest time that the port should occur on the target port in date. Expected format is ISO Offset Time, example: ‘10:15:00-08:00'. We can't guarantee the exact date and time, as this depends on the losing carrier

    • port_in_request_status string | null

      The status of the port in request. The possible values are: In progress, Completed, Expired, In review, Waiting for Signature, Action Required, and Canceled.

    • losing_carrier_information object | null

      Details regarding the customer’s information with the losing carrier. These values will be used to generate the letter of authorization and should match the losing carrier’s data as closely as possible to ensure the port is accepted.

    • phone_numbers array | null
    • documents array[string] | null

      List of document SIDs for all phone numbers included in the port in request. At least one document SID referring to a document of the type Utility Bill is required.

    • date_created string(date-time) | null
POST /v1/Porting/PortIn
curl \
 --request POST 'https://numbers.twilio.com/v1/Porting/PortIn' \
 --user "username:password" \
 --header "Content-Type: application/json"
Request examples
{}
Response examples (202)
{
  "url": "https://numbers.twilio.com/v1/Porting/PortIn/KWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "documents": [
    "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  ],
  "account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "date_created": "2023-09-10T06:52:21Z",
  "phone_numbers": [
    {
      "pin": "123456",
      "portable": true,
      "phone_number": "+16175551212",
      "not_portability_reason": "string",
      "port_in_phone_number_sid": "PUaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
      "not_portability_reason_code": 0,
      "port_in_phone_number_status": "In Review"
    }
  ],
  "notification_emails": [
    "user@domain.com"
  ],
  "port_in_request_sid": "KWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "target_port_in_date": "2023-09-10",
  "port_in_request_status": "pending",
  "losing_carrier_information": {
    "address": {
      "zip": "000000",
      "city": "City",
      "state": "State",
      "street": "Your Street",
      "country": "US",
      "street_2": "Other Street or null"
    },
    "address_sid": "ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
    "customer_name": "Customer name for carrier",
    "customer_type": "Business/Individual",
    "account_number": "123456",
    "account_telephone_number": "+133232323",
    "authorized_representative": "John Smith",
    "authorized_representative_email": "signer@domain.com"
  },
  "target_port_in_time_range_end": "20:00:00+01:00",
  "target_port_in_time_range_start": "10:00:00+01:00"
}