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

# Retrieve number

> Get details for a phone number.

### Parameters

<ParamField path="number" type="string" required>
  Phone number to retrieve (with country code) e.g. `14157271367`
</ParamField>

### Response

<ResponseField name="number" type="object">
  The details of the phone number.

  <Expandable title="number fields">
    <ResponseField name="phoneNumber" type="string">
      The phone number in E.164 format.
    </ResponseField>

    <ResponseField name="campaignId" type="string">
      The ID of the associated campaign.
    </ResponseField>

    <ResponseField name="isDefault" type="boolean">
      Whether the number is default for the campaign.
    </ResponseField>

    <ResponseField name="status" type="string">
      The status of the phone number.

      <Expandable title="number statuses">
        <ResponseField name="PENDING" type="string">
          The number is waiting for provisioning.
        </ResponseField>

        <ResponseField name="ACTIVE" type="string">
          The phone number is fully active.
        </ResponseField>

        <ResponseField name="DELETED" type="string">
          The phone number has been deleted.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="forwardNumber" type="boolean">
      Phone number for call forwarding (optional).
    </ResponseField>

    <ResponseField name="forwardEnabled" type="boolean">
      Whether call forwarding is enabled.
    </ResponseField>

    <ResponseField name="formattedNumber" type="string">
      The phone number formatted for display.
    </ResponseField>

    <ResponseField name="monthlyPrice" type="number">
      Monthly price of the number (in dollars).
    </ResponseField>

    <ResponseField name="purchasedAt" type="timestamp">
      Time at which the number was purchased.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="error" type="string">
  Error message if the request fails.
</ResponseField>

<ResponseExample>
  ```json Success theme={null}
  {
    "number": {
      "phoneNumber": "+14157271367",
      "campaignId": "U7fQ39nA",
      "isDefault": true,
      "status": "ACTIVE",
      "forwardNumber": null,
      "forwardEnabled": false,
      "formattedNumber": "(415) 727-1367",
      "monthlyPrice": 2,
      "purchasedAt": "2023-09-21T00:42:01.013Z"
    }
  }
  ```

  ```json Error theme={null}
  {
    "error": "Number not found"
  }
  ```
</ResponseExample>