Skip to main content
POST
/
v1
/
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

​
authorization
string
required
Your API key for authentication.

​
Body

​
phone_numbers
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.
​
losing_carrier_information
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
​
target_port_date
string
Requested port date in ISO 8601 format. Must be at least 7 days from today. If omitted, the earliest possible date is used.
​
documents
array
Array of document SIDs returned from POST /v1/sip/port/document.
​
pin
string
Account PIN from the losing carrier (required for some numbers — check via portability endpoint).

​
Response

​
port_request_id
string
Unique identifier for the port request.
​
status
string
Initial status: "waiting_for_signature".
​
signature_url
string
URL for electronically signing the Letter of Authorization.
​
phone_numbers
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