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

# List Port Requests

> List all number porting requests for your organization.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Response

**port\_requests** `array`

Array of port request objects. Each includes:

* `id` (string) — Port request ID
* `status` (string) — Current status: `"waiting_for_signature"`, `"submitted"`, `"in_progress"`, `"completed"`, `"canceled"`, `"failed"`
* `phone_numbers` (array) — Numbers included in the port, each with individual status
* `authorized_rep_email` (string) — Email of the authorized representative
* `notification_emails` (array) — Notification email addresses
* `created_at` (string) — ISO 8601 timestamp
* `updated_at` (string) — ISO 8601 timestamp

```json Example Request theme={null}
curl -X GET https://api.bland.ai/v1/sip/port \
  -H "Authorization: Bearer <token>"
```

```json Response theme={null}
{
  "data": {
    "port_requests": [
      {
        "id": "port_xyz789",
        "status": "in_progress",
        "phone_numbers": [
          { "number": "+14150000000", "status": "in_progress" },
          { "number": "+14150000001", "status": "in_progress" }
        ],
        "authorized_rep_email": "jane@acme.com",
        "notification_emails": ["it@acme.com"],
        "created_at": "2026-03-09T12:00:00Z",
        "updated_at": "2026-03-12T08:00:00Z"
      }
    ]
  },
  "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.