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

# Check Number Portability

> Check whether phone numbers are eligible for porting to Bland.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**phone\_numbers** `string[]` *required*

Array of phone numbers to check. Must be in E.164 format.

### Response

**results** `array`

Array of portability check results. Each includes:

* `phone_number` (string) — The phone number checked
* `portable` (boolean) — Whether the number can be ported
* `number_type` (string) — Type of number: `"mobile"`, `"landline"`, `"toll-free"`, etc.
* `pin_required` (boolean) — Whether a PIN from the losing carrier is required

```json Example Request theme={null}
curl -X GET 'https://api.bland.ai/v1/sip/port/check?phone_numbers[]=%2B14150000000&phone_numbers[]=%2B14150000001' \
  -H "Authorization: Bearer <token>"
```

```json Response theme={null}
{
  "data": {
    "results": [
      {
        "phone_number": "+14150000000",
        "portable": true,
        "number_type": "landline",
        "pin_required": false
      },
      {
        "phone_number": "+14150000001",
        "portable": true,
        "number_type": "mobile",
        "pin_required": true
      }
    ]
  },
  "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.