Search available phone numbers

carrier is always required, because carriers do not sell the same numbers. Call without one and the 409 carrier_required response lists that region's carriers with what each one stocks, so an integration discovers a carrier we add later without a release of its own.

The response names the carrier its results came from, and that is the carrier the a purchase has to pass. Verification is per carrier too, so a client must be verified on the carrier it is buying from.

Searching does not reserve anything. A number is claimed only when a purchase starts, so one you saw a moment ago can be gone by the time you buy it.

The carrier table and the flow end to end are in Buy a number over the API.

curl -X GET 'https://omnidim.io/api/v1/phone_number/search?region=IN&carrier=carrier-1&pattern=555&page=1&limit=20' \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "success": true,
  "region": "IN",
  "carrier": "carrier-1",
  "carrier_label": "Carrier 1",
  "numbers": [
    {
      "phone_number": "+918000000001",
      "monthly_rental_usd": 5.06,
      "validity_days": 30,
      "region": "IN",
      "kyc_required": true
    }
  ],
  "total": 1,
  "page": 1,
  "limit": 20,
  "total_pages": 1
}