> ## 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.

# Search numbers

> Search for available numbers.

### URL Params

<ParamField query="areaCode" type="string">
  Area code for available numbers (optional).
</ParamField>

<ParamField query="related" default="true" type="boolean">
  Return nearby numbers if none available.
</ParamField>

### Response

<ResponseField name="numbers" type="[number]">
  Array of available numbers (max 5).

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

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

    <ResponseField name="location" type="string">
      Location of the area code (rate center).
    </ResponseField>

    <ResponseField name="monthlyPrice" type="number">
      The monthly price of the number.
    </ResponseField>
  </Expandable>
</ResponseField>

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

<ResponseExample>
  ```json Success theme={null}
  {
    "numbers": [
      {
        "number": "+14155941075",
        "formattedNumber": "(415) 594-1075",
        "location": "San Francisco, CA",
        "monthlyPrice": 2
      },
      {
        "number": "+14155941076",
        "formattedNumber": "(415) 594-1076",
        "location": "San Francisco, CA",
        "monthlyPrice": 2
      },
      {
        "number": "+14155941079",
        "formattedNumber": "(415) 594-1079",
        "location": "San Francisco, CA",
        "monthlyPrice": 2
      },
      {
        "number": "+14155941081",
        "formattedNumber": "(415) 594-1081",
        "location": "San Francisco, CA",
        "monthlyPrice": 2
      },
      {
        "number": "+14155941086",
        "formattedNumber": "(415) 594-1086",
        "location": "San Francisco, CA",
        "monthlyPrice": 2
      }
    ]
  }
  ```

  ```json Error theme={null}
  {
    "numbers": [],
    "error": "No numbers found"
  }
  ```
</ResponseExample>