Initiate Port Request

curl --request POST \
  --url https://api.bland.ai/v1/sip/port/initiate \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "phone_numbers": [
    {}
  ],
  "losing_carrier_information": {},
  "target_port_date": "<string>",
  "documents": [
    {}
  ],
  "pin": "<string>"
}
'

import requests

url = "https://api.bland.ai/v1/sip/port/initiate"

payload = {
    "phone_numbers": [{}],
    "losing_carrier_information": {},
    "target_port_date": "<string>",
    "documents": [{}],
    "pin": "<string>"
}
headers = {
    "authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phone_numbers: [{}],
    losing_carrier_information: {},
    target_port_date: '<string>',
    documents: [{}],
    pin: '<string>'
  })
};

fetch('https://api.bland.ai/v1/sip/port/initiate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/sip/port/initiate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_numbers' => [
        [
                
        ]
    ],
    'losing_carrier_information' => [
        
    ],
    'target_port_date' => '<string>',
    'documents' => [
        [
                
        ]
    ],
    'pin' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/sip/port/initiate"

	payload := strings.NewReader("{\n  \"phone_numbers\": [\n    {}\n  ],\n  \"losing_carrier_information\": {},\n  \"target_port_date\": \"<string>\",\n  \"documents\": [\n    {}\n  ],\n  \"pin\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/sip/port/initiate")
  .header("authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_numbers\": [\n    {}\n  ],\n  \"losing_carrier_information\": {},\n  \"target_port_date\": \"<string>\",\n  \"documents\": [\n    {}\n  ],\n  \"pin\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/sip/port/initiate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_numbers\": [\n    {}\n  ],\n  \"losing_carrier_information\": {},\n  \"target_port_date\": \"<string>\",\n  \"documents\": [\n    {}\n  ],\n  \"pin\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "port_request_id": "port_xyz789",
    "status": "waiting_for_signature",
    "signature_url": "https://sign.example.com/loa/port_xyz789",
    "phone_numbers": ["+14150000000", "+14150000001"]
  },
  "errors": null
}

POST

sip

port

initiate

Initiate Port Request

curl --request POST \
  --url https://api.bland.ai/v1/sip/port/initiate \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "phone_numbers": [
    {}
  ],
  "losing_carrier_information": {},
  "target_port_date": "<string>",
  "documents": [
    {}
  ],
  "pin": "<string>"
}
'

import requests

url = "https://api.bland.ai/v1/sip/port/initiate"

payload = {
    "phone_numbers": [{}],
    "losing_carrier_information": {},
    "target_port_date": "<string>",
    "documents": [{}],
    "pin": "<string>"
}
headers = {
    "authorization": "<authorization>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    phone_numbers: [{}],
    losing_carrier_information: {},
    target_port_date: '<string>',
    documents: [{}],
    pin: '<string>'
  })
};

fetch('https://api.bland.ai/v1/sip/port/initiate', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bland.ai/v1/sip/port/initiate",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'phone_numbers' => [
        [
                
        ]
    ],
    'losing_carrier_information' => [
        
    ],
    'target_port_date' => '<string>',
    'documents' => [
        [
                
        ]
    ],
    'pin' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.bland.ai/v1/sip/port/initiate"

	payload := strings.NewReader("{\n  \"phone_numbers\": [\n    {}\n  ],\n  \"losing_carrier_information\": {},\n  \"target_port_date\": \"<string>\",\n  \"documents\": [\n    {}\n  ],\n  \"pin\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("authorization", "<authorization>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/sip/port/initiate")
  .header("authorization", "<authorization>")
  .header("Content-Type", "application/json")
  .body("{\n  \"phone_numbers\": [\n    {}\n  ],\n  \"losing_carrier_information\": {},\n  \"target_port_date\": \"<string>\",\n  \"documents\": [\n    {}\n  ],\n  \"pin\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.bland.ai/v1/sip/port/initiate")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"phone_numbers\": [\n    {}\n  ],\n  \"losing_carrier_information\": {},\n  \"target_port_date\": \"<string>\",\n  \"documents\": [\n    {}\n  ],\n  \"pin\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "port_request_id": "port_xyz789",
    "status": "waiting_for_signature",
    "signature_url": "https://sign.example.com/loa/port_xyz789",
    "phone_numbers": ["+14150000000", "+14150000001"]
  },
  "errors": null
}

Headers

string

required

Your API key for authentication.

Body

array

required

Array of phone numbers to port. Each must be in E.164 format. You should verify portability first using GET /v1/sip/port/check.

object

required

Information about the current carrier:

customer_type (string) — "business" or "personal"
business_name (string) — Business name on the account (if business)
first_name (string) — Account holder first name
last_name (string) — Account holder last name
account_number (string) — Account number with the losing carrier
authorized_representative_email (string) — Email for LOA signing
notification_emails (array) — Additional emails for status updates
address (object) — Service address: street, street2, city, state, zip, country

string

Requested port date in ISO 8601 format. Must be at least 7 days from today. If omitted, the earliest possible date is used.

array

Array of document SIDs returned from POST /v1/sip/port/document.

string

Account PIN from the losing carrier (required for some numbers — check via portability endpoint).

Response

string

Unique identifier for the port request.

string

Initial status: "waiting_for_signature".

string

URL for electronically signing the Letter of Authorization.

array

Array of phone numbers included in the port request.

Number porting typically takes 7–14 business days. Track progress via GET /v1/sip/port or the SIP Dashboard. Port status flow: waiting_for_signature → submitted → in_progress → completed

Example Request

curl -X POST https://api.bland.ai/v1/sip/port/initiate \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_numbers": ["+14150000000", "+14150000001"],
    "losing_carrier_information": {
      "customer_type": "business",
      "business_name": "Acme Corp",
      "first_name": "Jane",
      "last_name": "Doe",
      "account_number": "ACC-12345",
      "authorized_representative_email": "jane@acme.com",
      "notification_emails": ["it@acme.com"],
      "address": {
        "street": "123 Main St",
        "street2": "Suite 100",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94105",
        "country": "US"
      }
    },
    "target_port_date": "2026-03-20T00:00:00Z",
    "documents": ["doc_abc123"]
  }'

{
  "data": {
    "port_request_id": "port_xyz789",
    "status": "waiting_for_signature",
    "signature_url": "https://sign.example.com/loa/port_xyz789",
    "phone_numbers": ["+14150000000", "+14150000001"]
  },
  "errors": null
}

Docs for agents: llms.txt

Upload Port Document List Port Requests

⌘I

Basic Tutorials

Calls

Voices & Text to Speech

Conversational Pathways

Knowledge Bases

Numbers

Blocked Numbers

Widgets

Tools

Contacts

Memory

Node tests

Agent Testing

Evals

Guard Rails

Web Agents

Live Translation

Custom Twilio Accounts

Batches

Prompts

Account

Organizations

Messaging

SIP Trunks

Custom Dialing Pools

Personas

Citation Schemas

Alarms

Triage

Initiate Port Request

Headers

Body

Response

​Headers

​Body

​Response

Headers

Body

Response