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

# Get Phone Number

> Retrieve a single phone number by its ID.

<RequestExample>
  ```typescript TypeScript theme={null}
  import { CommuneClient } from 'commune-ai';

  const commune = new CommuneClient({ apiKey: process.env.COMMUNE_API_KEY });

  const phoneNumber = await commune.phoneNumbers.get('pn_01abc123');

  console.log(phoneNumber.number);  // +18005550001
  console.log(phoneNumber.status);  // active
  ```

  ```python Python theme={null}
  from commune import CommuneClient

  client = CommuneClient()

  phone_number = client.phone_numbers.get("pn_01abc123")

  print(phone_number.number)  # +18005550001
  print(phone_number.status)  # active
  ```

  ```bash MCP theme={null}
  get_phone_number(id="pn_01abc123")
  ```

  ```bash cURL theme={null}
  curl https://api.commune.email/v1/phone-numbers/pn_01abc123 \
    -H "Authorization: Bearer comm_..."
  ```

  ```bash CLI theme={null}
  commune phone-numbers get pn_01abc123
  ```
</RequestExample>

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": {
      "id": "pn_01abc123",
      "number": "+18005550001",
      "numberType": "tollfree",
      "friendlyName": "Support Line",
      "country": "US",
      "capabilities": {
        "sms": true,
        "mms": true,
        "voice": true
      },
      "status": "active",
      "allowList": [],
      "blockList": [],
      "creditCostPerMonth": 150,
      "autoReply": null,
      "createdAt": "2026-02-01T00:00:00.000Z",
      "updatedAt": "2026-02-25T10:00:00.000Z"
    }
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "Phone number not found"
  }
  ```
</ResponseExample>

## Path Parameters

<ParamField path="id" type="string" required>
  The phone number ID. Format: `pn_...`
</ParamField>

## Response

<ResponseField name="data" type="object">
  The phone number record.

  <Expandable title="properties" defaultOpen>
    <ResponseField name="id" type="string">
      Unique phone number ID. Format: `pn_...`
    </ResponseField>

    <ResponseField name="number" type="string">
      Phone number in E.164 format.
    </ResponseField>

    <ResponseField name="numberType" type="string">
      One of: `local`, `tollfree`, `shortcode`.
    </ResponseField>

    <ResponseField name="friendlyName" type="string | null">
      Display name for this number.
    </ResponseField>

    <ResponseField name="country" type="string">
      ISO-3166 country code.
    </ResponseField>

    <ResponseField name="capabilities" type="object">
      <Expandable title="properties">
        <ResponseField name="sms" type="boolean">SMS enabled.</ResponseField>
        <ResponseField name="mms" type="boolean">MMS enabled.</ResponseField>
        <ResponseField name="voice" type="boolean">Voice enabled.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="status" type="string">
      One of: `active`, `released`, `suspended_non_payment`.
    </ResponseField>

    <ResponseField name="allowList" type="string[]">
      E.164 numbers in the allow list. Empty = all allowed.
    </ResponseField>

    <ResponseField name="blockList" type="string[]">
      E.164 numbers in the block list.
    </ResponseField>

    <ResponseField name="creditCostPerMonth" type="number">
      Monthly credit cost (150).
    </ResponseField>

    <ResponseField name="autoReply" type="object | null">
      Auto-reply configuration.

      <Expandable title="properties">
        <ResponseField name="enabled" type="boolean">Whether auto-reply is active.</ResponseField>
        <ResponseField name="body" type="string">The auto-reply message text.</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="createdAt" type="string">ISO 8601 timestamp.</ResponseField>
    <ResponseField name="updatedAt" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>


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