Help

Why Does My Bulk Domain Search Return an invalid Array?

The API handles invalid domain values without failing the entire bulk request.

When you submit a bulk search that includes a mix of valid and malformed domain strings:

  • Valid domains are processed normally and returned in the data array.

  • Invalid or malformed values are returned in the invalid array.

This allows the request to complete successfully (partial success), while still clearly identifying which inputs could not be processed.

Example Response (Partial Success on Bulk Search):

JSON
{
  "status": "success",
  "code": "OK",
  "message": "",
  "invalid": [
    "invalid_domain_name!@#"
  ],
  "data": [
    {
      "domain_name": "VALID-SEARCH.NET",
      "tld": ".NET",
      "available": true,
      "available_terms": [ 1, 2, 3 ],
      "pricing": [
        {
          "term_years": 1,
          "register": "15.50",
          "renew": "15.50",
          "transfer": "15.50",
          "currency": "USD",
          "premium": false
        }
      ]
    }
  ]
}