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

# Buscar números de teléfono disponibles

> Busca números de teléfono disponibles que se pueden comprar

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint te permite buscar números de teléfono disponibles a través de nuestro proveedor. Usa los resultados para encontrar el número que quieres comprar.

### Parámetros de consulta

<ParamField query="country_code" type="string" default="DE">
  El código de país ISO 3166-1 alfa-2 en el que buscar (p. ej., DE, GB, AU, CA)
</ParamField>

<ParamField query="contains" type="string">
  Filtra los números de teléfono que contienen dígitos específicos (solo caracteres numéricos, máximo 10 dígitos)
</ParamField>

### Campos de respuesta

<ResponseField name="data" type="array">
  Array de números de teléfono disponibles

  <Expandable title="Propiedades del número disponible">
    <ResponseField name="phone_number" type="string">
      El número de teléfono en formato E.164
    </ResponseField>

    <ResponseField name="phone_number_formatted" type="string">
      El número de teléfono formateado para mostrar
    </ResponseField>

    <ResponseField name="country_code" type="string">
      El código de país ISO
    </ResponseField>

    <ResponseField name="price" type="number">
      Precio de alquiler mensual en USD
    </ResponseField>

    <ResponseField name="stripe_price_id" type="string">
      El ID de precio de Stripe para la facturación
    </ResponseField>

    <ResponseField name="address_requirements" type="string">
      Requisitos de dirección para este número: `none`, `local`, `foreign` o `inventory`
    </ResponseField>

    <ResponseField name="sms_capable" type="boolean">
      Si el número admite SMS
    </ResponseField>
  </Expandable>
</ResponseField>

### Países admitidos

| País           | Código |
| -------------- | ------ |
| Alemania       | DE     |
| Estados Unidos | US     |
| Canadá         | CA     |
| Reino Unido    | GB     |
| Australia      | AU     |
| Israel         | IL     |
| Polonia        | PL     |
| Finlandia      | FI     |
| Países Bajos   | NL     |
| Dinamarca      | DK     |
| Italia         | IT     |

<ResponseExample>
  ```json 200 Success theme={null}
  {
    "data": [
      {
        "phone_number": "+14155551234",
        "phone_number_formatted": "+1 415-555-1234",
        "country_code": "US",
        "price": 3.99,
        "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
        "address_requirements": "none",
        "sms_capable": true
      },
      {
        "phone_number": "+14155555678",
        "phone_number_formatted": "+1 415-555-5678",
        "country_code": "US",
        "price": 3.99,
        "stripe_price_id": "price_1PkA4dBXoZOzqQuAsvGvVJTZ",
        "address_requirements": "none",
        "sms_capable": false
      }
    ]
  }
  ```

  ```json 200 Empty Response theme={null}
  {
    "data": []
  }
  ```
</ResponseExample>

<Tip>
  Páginas relacionadas: [Introducción](/es/api-v1/introduction) y [Guía de autenticación](/es/api-v1/authentication), y [Ejemplos de integración de la API](/es/api-v1/introduction).
</Tip>