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
dataarray. -
Invalid or malformed values are returned in the
invalidarray.
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
}
]
}
]
}