# Domain whois lookup

`GET /whois/@domain` · public, no token

Looks up the whois of a domain with no token (call `https://api.tino.vn` directly, not through the `/v1` gateway). It always answers HTTP 200 with `success: true`; read the result in this order:

- `error` present (e.g. `incorrect_tld`: invalid extension or one that cannot be looked up): ignore `available`; the answer still says `available: true`.
- `raw` is `Rate limit exceeded`: too many lookups; `available: false` then does not mean the domain is taken. Wait and look it up again.
- `domain` is an extension Tino sells (e.g. `vn`): only `success`, `domain`, `available: false`.
- `available: true`, `status: ok`, `whois: []`: no whois data for the domain (`raw` is the raw text or `Domain not found`).
- `available: false` with a `whois` object: the domain is taken. Fields appear when the registry returns them: `domain`, `registrar`, `createDate`, `expiredDate`, `updatedDate`, `registrantName`, `registrantOrg`, `nameservers`, `Dnssec`, `status`, `WhoisServer`, `DomainReserved`. Dates keep the registry's format (e.g. `+07:00` for `.vn`, `Z` for `.com`).

`raw` is the raw whois text: lines end with `<br />` and special characters are HTML-encoded.

## HTTP request

| Item | Value |
| --- | --- |
| URL | `https://api.tino.vn/whois/@domain` |
| Method | `GET` |
| Authentication | no token: call `https://api.tino.vn` directly, not through the `/v1` gateway |
| Content-Type | — (no body) |

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `domain` | path | string | yes | Domain to look up (e.g. `tino.vn`), or an extension (e.g. `vn`) |

## Example request

```bash
curl "https://api.tino.vn/whois/tino.vn"
```

A public route: the example sends no token. Path parameters in the example are sample values.

SDK ([SDK & examples](/en/docs/sdk)): Python `client.domains.whois(domain)`, Node.js `await client.domains.whois(domain);`, PHP `$client->domains->whois($domain);`.

## Example response

```json
{
 "success": true,
 "domain": "tino.vn",
 "available": false,
 "status": "",
 "whois": {
  "domain": "tino.vn",
  "registrar": "Công ty Cổ phần Tập đoàn Tino",
  "createDate": "2022-02-02T16:32:35+07:00",
  "expiredDate": "2035-02-02T16:32:35+07:00",
  "registrantName": "CÔNG TY CỔ PHẦN TẬP ĐOÀN TINO",
  "nameservers": [
   "ns1.tino.vn",
   "ns2.tino.vn"
  ],
  "Dnssec": "unsigned",
  "status": [
   "clientDeleteProhibited",
   "clientTransferProhibited",
   "serverUpdateProhibited",
   "serverDeleteProhibited",
   "serverTransferProhibited"
  ]
 },
 "raw": "Dnssec: unsigned<br />Domain Name: tino.vn<br />Registry Expiry Date: 2035-02-02T16:32:35+07:00<br />…"
}
```

Live sample from 2026-10-26 for a Tino domain; `raw` is trimmed.