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

# Get port status

> GET /api/v1/comms/lines/{e164}/port — status for a locked dedicated line (no LNP secrets).

Returns port status for a locked dedicated line. Never includes LNP secrets or ciphertext.

<Warning>
  **Access required.** Request permission to use the Line Port API before calling this endpoint.
</Warning>

**Scope:** `comms_lines_read` (write also satisfies read)

## Request

```bash theme={null}
curl "https://osis.co/api/v1/comms/lines/%2B16285551212/port" \
  -H "Authorization: Bearer $COMMS_API_KEY"
```

### Path parameters

<ParamField path="e164" type="string" required>
  The locked dedicated E.164 (URL-encoded).
</ParamField>

## Response

### 200 OK

```json theme={null}
{
  "port": {
    "id": "lport_…",
    "org_id": "comms_usr_…",
    "locked_e164": "+16285551212",
    "target_e164": "+12125550147",
    "status": "port_in_progress",
    "error_code": null,
    "error_message": null,
    "submitted_at": "2026-08-12T14:05:00.000Z",
    "foc_at": null,
    "completed_at": null,
    "created_at": "2026-08-12T14:00:00.000Z",
    "updated_at": "2026-08-12T14:10:00.000Z"
  }
}
```

Statuses: `number_locked` → `port_submitted` → `port_in_progress` → `port_completed` (or `port_failed`).