Phone Numbers

Search rentable phone numbers in inventory

Changed on

Searches the telephony provider's inventory for available numbers matching the requested country (and optional area code). Returns up to 5 candidates per call.

Use the returned phoneNumber value in POST /product/rent-number to actually rent it.

get/product/get-available-numbers

Request

  • Base URL
    https://api.smallest.ai/atoms/v1
  • URL
    https://api.smallest.ai/atoms/v1/product/get-available-numbers
  • Auth
    HTTP bearer

Query parameters

countryCodestring required

ISO 3166-1 alpha-2 country code (e.g. US, IN, GB).

provider'twilio' | 'plivo' | 'custom' | 'whatsapp' required

Telephony provider to search.

areaCodestring

Optional area-code / region filter — provider-dependent (US area codes for plivo/twilio, etc.).

Response

Successful response

statusboolean

Example response

{
  "status": true,
  "data": [
    {
      "phoneNumber": "13183747513",
      "countryCode": "US",
      "provider": "plivo",
      "areaCode": "Louisiana"
    }
  ]
}

Changes

  • 49ce8525306eRevision changes
    • warning

      added the new custom enum value to the // response property for the response status

    • warning

      added the new whatsapp enum value to the // response property for the response status

    • info

      added the new enum value custom to the query request parameter provider

    • info

      added the new enum value whatsapp to the query request parameter provider

  • 4cc40f995db8Revision changes
    • info

      endpoint added