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

# Get Phone Number

Get details of a specific phone number.

### Headers

<ParamField header="X-API-Key" type="string" required>
  Your API key for authentication.
</ParamField>

<ParamField header="X-Organization-Id" type="string" required>
  The organization ID.
</ParamField>

### Path Parameters

<ParamField path="phone_number_id" type="string" required>
  The unique identifier of the phone number (format: `phon_[a-f0-9]{12,}`).
</ParamField>

### Permissions

* `phone_numbers:read` (all roles)

### Response

<ResponseField name="success" type="boolean">
  Indicates if the request was successful.
</ResponseField>

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

  <Expandable title="properties">
    <ResponseField name="phone_number_id" type="string">
      Unique phone number identifier.
    </ResponseField>

    <ResponseField name="phone_number" type="string">
      The phone number in E.164 format.
    </ResponseField>

    <ResponseField name="client_id" type="string">
      Organization ID.
    </ResponseField>

    <ResponseField name="provider" type="string">
      Provider type (`twilio` or `sip`).
    </ResponseField>

    <ResponseField name="status" type="string">
      Status (`free` or `assigned`).
    </ResponseField>

    <ResponseField name="supports_inbound" type="boolean">
      Whether number supports inbound calls.
    </ResponseField>

    <ResponseField name="supports_outbound" type="boolean">
      Whether number supports outbound calls.
    </ResponseField>

    <ResponseField name="assigned_agent_id" type="string">
      ID of assigned agent (if any).
    </ResponseField>

    <ResponseField name="integration_id" type="string">
      Integration ID (for Twilio numbers).
    </ResponseField>

    <ResponseField name="sip_trunk_info" type="object">
      SIP trunk configuration (for SIP numbers).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp of creation.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp of last update.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "success": true,
    "data": {
      "phone_number_id": "phon_a1b2c3d4e5f6",
      "phone_number": "+15551234567",
      "client_id": "org_abc123",
      "provider": "twilio",
      "status": "assigned",
      "supports_inbound": true,
      "supports_outbound": true,
      "assigned_agent_id": "agent_b2c3d4e5f6a7",
      "integration_id": "intg_c3d4e5f6a7b8",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-20T14:45:00Z"
    }
  }
  ```
</ResponseExample>