About this endpoint
What it does
Checks domain availability across one or more TLDs using RDAP and returns a JSON object with the queried name, an optional note, a results array, and a checked_at timestamp.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| name | String | Yes | Domain name label to check. Max length: 63 characters. |
| tlds | String | No | TLD list to check. Max length: 200 characters. |
Response
Returns a JSON object with name and note string fields, a results array of objects, and a checked_at date-time string. Each item in results describes one TLD check with the domain label, domain, status, expiration info, registrar info, investor score, and a likely-available flag.
| Parameter | Type | Description |
|---|---|---|
| name | String | Domain name that was checked. |
| note | String | Additional information about the response, if provided. |
| results | Object Array | Array of result objects for each checked TLD. |
| results[].label | String | Label for the checked TLD result. |
| results[].domain | String | Full domain that was checked. |
| results[].domain_unicode | String | Unicode (IDN) form of the domain when the name contains non-ASCII characters, or null. |
| results[].tld | String | The TLD this result row is for. |
| results[].status | ENUM | Availability/status value. Allowed values: registered, registered_dns_only, not_found_in_rdap, unknown, not_checked. |
| results[].expires | String | Expiration value, or null. |
| results[].registrar | String | Registrar value, or null. |
| results[].lifecycle | String | Domain lifecycle state (e.g. active), or null. |
| results[].dns_hint | String | DNS-based hint used when RDAP data isn't available for the TLD, or null. |
| results[].investor_score | Integer | Investor score returned for the result. |
| results[].likely_available | Boolean | Availability hint, or null. |
| checked_at | String | Timestamp for when the check was performed, in date-time format. |


