# Search the carrier for numbers available to buy

Source: https://docs.usetone.ai/reference/numbers/available

> Live carrier inventory, so results go stale — a number can be taken between this call and your purchase, which is a `409 number_unavailable`.

`GET /v1/numbers/available`
Live carrier inventory, so results go stale — a number can be taken between this call and your purchase, which is a `409 number_unavailable`. Only regular numbers are offered: the 140 and 160 series are not purchasable through any carrier API.

Requires the `read` scope.

## Parameters

| Name | In | | Meaning |
|---|---|---|---|
| `number_type` | query | optional | Which kind of number to search for. Open set — handle an unrecognised value rather than throwing. Today: `landline`, `mobile`, `tollfree`. |
| `region` | query | optional | Telecom circle code, uppercase — list them with GET /v1/numbers/regions. Omit to search the carrier default pool. |
| `contains` | query | optional | Digits the number must contain. Digits only — carriers treat other characters inconsistently. |
| `sms` | query | optional | Only numbers that can also send SMS. Note that SMS itself additionally requires DLT registration. |
| `limit` | query | optional | How many results to return. 1-50, defaulting to 20. |

## Response



### Example response

```json
{
  "data": [
    {
      "capabilities": {
        "sms": false,
        "voice": true
      },
      "e164": "+918045678901",
      "numberType": "landline",
      "region": "KA",
      "rentalPaise": 0,
      "setupPaise": 0,
      "totalPaise": 0
    }
  ]
}
```