> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Initiate Port Request

> Submit a number porting request to transfer phone numbers from another carrier to Bland.

### 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 account with the current carrier. It must match the carrier's records exactly.

* `customer_type` (string, required): `"Business"` or `"Individual"`. Values are case-sensitive.
* `customer_name` (string, required): Name on the carrier account.
* `account_number` (string): Account number with the losing carrier.
* `account_telephone_number` (string, required): Billing telephone number on the carrier account.
* `authorized_representative` (string, required): Full name of the person authorized to port the numbers.
* `authorized_representative_email` (string, required): Email that receives the Letter of Authorization to sign.
* `address` (object, required): Service address with `street`, `street_2` (optional), `city`, `state`, `zip`, and `country`.

**target\_port\_in\_date** `string` *required*

Requested port date in `YYYY-MM-DD` format. Must be at least 4 days from today.

**documents** `array` *required*

Array of document SIDs returned from `POST /v1/sip/port/document`. At least one is required.

**phone\_number\_pins** `object`

Map of phone number to its account PIN with the losing carrier, for example `{"+14150000000": "1234"}`. Required for numbers where the portability check returns `pin_required`.

**notification\_emails** `array`

Emails that receive port status updates. Defaults to `authorized_representative_email`.

### 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`

```json Example Request theme={null}
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",
      "customer_name": "Acme Corp",
      "account_number": "ACC-12345",
      "account_telephone_number": "+14150000000",
      "authorized_representative": "Jane Doe",
      "authorized_representative_email": "jane@acme.com",
      "address": {
        "street": "123 Main St",
        "street_2": "Suite 100",
        "city": "San Francisco",
        "state": "CA",
        "zip": "94105",
        "country": "US"
      }
    },
    "target_port_in_date": "2026-03-20",
    "notification_emails": ["it@acme.com"],
    "documents": ["doc_abc123"]
  }'
```

```json Response theme={null}
{
  "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](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.