Search Domain Availability

Search Domain Availability: Use this to check if a specific domain is available for registration. It performs a real-time lookup via the registrar and also returns the specific price for that domain, which is crucial for handling premium domains with dynamic pricing. The API sanitizes user input automatically by stripping prefixes like http://, https://, and www..

Endpoint: GET /search

Parameters:

  • domain (required, string, max 255 chars): Full domain name to search (e.g., 'example.com'). If you just send the Second-Level Domain (e.g., 'example'), it will intelligently search against and return pricing/availability objects for a list of 12 primary TLDs (e.g., .com, .net, .io, .xyz).

Example Request:

curl -X GET "https://umva.net/api/domain/search?domain=example.com" 
  -H "X-API-Key: your_api_key_here"

Success Response Example (HTTP 200 - Single Domain):

{
  "success": true,
  "results": [
    {
      "domain": "example.com",
      "extension": "com",
      "pricing": {
        "register_1year": 10.99,
        "renew_1year": 10.99,
        "transfer_1year": 10.99
      },
      "available": true
    }
  ]
}

Example Request (Search Without TLD):

curl -X GET "https://umva.net/api/domain/search?domain=example" 
  -H "X-API-Key: your_api_key_here"

Success Response Example (HTTP 200 - Multiple Primary TLDs):

{
  "success": true,
  "results": [
    {
      "domain": "example.com",
      "extension": "com",
      "pricing": {
        "register_1year": 10.99,
        "renew_1year": 10.99,
        "transfer_1year": 10.99
      },
      "available": false
    },
    {
      "domain": "example.net",
      "extension": "net",
      "pricing": {
        "register_1year": 11.99,
        "renew_1year": 11.99,
        "transfer_1year": 11.99
      },
      "available": true
    }
  ]
}

Error Response Example (HTTP 400 - Unsupported TLD):

{
  "success": false,
  "message": "The TLD .unknown is not supported."
}

Error Response Example (HTTP 503 - Registrar issue):

{
  "success": false,
  "message": "Domain registration service is currently unavailable."
}