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

# Get a Phone Number

> Retrieve a provisioned phone number.

<ParamField path="number" type="string" required>
  Number ID (`pn_...`), E.164 phone number, or owning agent handle.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.wirebox.sh/api/v1/phone/numbers/eva" \
    -H "Authorization: Bearer $WIREBOX_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "pn_01J8ABC123DEF456",
    "phone_number": "+14155550123",
    "country_code": "US",
    "type": "local",
    "region": "CA",
    "agent_handle": "eva",
    "agent_identity_id": "agt_01J8ABC123DEF456",
    "status": "active",
    "sms_status": "ready",
    "sms_error_code": null,
    "sms_error_detail": null,
    "sms_ready_at": "2026-09-14T10:12:30Z",
    "capabilities": { "sms": true, "mms": true, "voice": false },
    "created_at": "2026-09-14T10:00:00Z",
    "updated_at": "2026-09-14T10:12:30Z"
  }
  ```
</ResponseExample>