# Domains & DNS

Look up, order and renew domains; nameservers, DNSSEC; DNS zones and records.

Every route is called through the gateway `https://api.tino.vn/v1` with `Authorization: Bearer <token>`; see [Calling the Tino API](/en/docs/api).

## Guides

- [Domain registrant dossier](/en/docs/domain-registrant)

## Domains

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/v1/domain` | [List domains](/en/docs/api/get-domain) | `domains:read` |
| `GET` | `/v1/domain/@id` | [Domain details](/en/docs/api/get-domain-id) | `domains:read` |
| `GET` | `/v1/domain/@id/autorenew` | [Get domain auto-renewal](/en/docs/api/get-domain-id-autorenew) | `domains:read` |
| `PUT` | `/v1/domain/@id/autorenew` | [Turn domain auto-renewal on or off](/en/docs/api/put-domain-id-autorenew) | `domains:write` |
| `GET` | `/v1/domain/@id/contact` | [Get domain contacts](/en/docs/api/get-domain-id-contact) | `domains:read` |
| `PUT` | `/v1/domain/@id/contact` | [Change domain contacts (registrant)](/en/docs/api/put-domain-id-contact) | `domains:owner` |
| `GET` | `/v1/domain/@id/dnssec` | [List DNSSEC keys](/en/docs/api/get-domain-id-dnssec) | `domains:read` |
| `PUT` | `/v1/domain/@id/dnssec` | [Add DNSSEC key](/en/docs/api/put-domain-id-dnssec) | `domains:write` |
| `DELETE` | `/v1/domain/@id/dnssec/@key` | [Delete DNSSEC key](/en/docs/api/delete-domain-id-dnssec-key) | `domains:write` |
| `GET` | `/v1/domain/@id/dnssec/flags` | [Supported DNSSEC parameters](/en/docs/api/get-domain-id-dnssec-flags) | `domains:read` |
| `GET` | `/v1/domain/@id/emforwarding` | [Get email forwarding](/en/docs/api/get-domain-id-emforwarding) | `domains:read` |
| `PUT` | `/v1/domain/@id/emforwarding` | [Update email forwarding](/en/docs/api/put-domain-id-emforwarding) | `domains:write` |
| `GET` | `/v1/domain/@id/epp` | [Get domain transfer code (EPP)](/en/docs/api/get-domain-id-epp) | `domains:owner` |
| `PUT` | `/v1/domain/@id/forwarding` | [Update domain forwarding](/en/docs/api/put-domain-id-forwarding) | `domains:write` |
| `PUT` | `/v1/domain/@id/idprotection` | [Turn registrant privacy on or off](/en/docs/api/put-domain-id-idprotection) | `domains:write` |
| `GET` | `/v1/domain/@id/invoices` | [Domain invoices](/en/docs/api/get-domain-id-invoices) | `domains:read` |
| `GET` | `/v1/domain/@id/ns` | [Get nameservers](/en/docs/api/get-domain-id-ns) | `domains:read` |
| `PUT` | `/v1/domain/@id/ns` | [Change nameservers](/en/docs/api/put-domain-id-ns) | `domains:write` |
| `GET` | `/v1/domain/@id/reg` | [Registered private nameservers](/en/docs/api/get-domain-id-reg) | `domains:read` |
| `POST` | `/v1/domain/@id/reg` | [Manage private nameservers](/en/docs/api/post-domain-id-reg) | `domains:write` |
| `GET` | `/v1/domain/@id/reglock` | [Get domain lock](/en/docs/api/get-domain-id-reglock) | `domains:read` |
| `PUT` | `/v1/domain/@id/reglock` | [Turn domain lock on or off](/en/docs/api/put-domain-id-reglock) | `domains:write` |
| `POST` | `/v1/domain/@id/renew` | [Renew domain](/en/docs/api/post-domain-id-renew) | `domains:write` |
| `GET` | `/v1/domain/@id/sync` | [Sync domain](/en/docs/api/get-domain-id-sync) | `domains:write` |
| `POST` | `/v1/domain/lookup` | [Check domain availability](/en/docs/api/post-domain-lookup) | `domains:read` |
| `GET` | `/v1/domain/name/@name` | [Domain details by name](/en/docs/api/get-domain-name-name) | `domains:read` |
| `GET` | `/v1/domain/order` | [Available domain extensions](/en/docs/api/get-domain-order) | `domains:read` |
| `POST` | `/v1/domain/order` | [Order domain](/en/docs/api/post-domain-order) | `domains:write` |
| `GET` | `/v1/domain/order/@id/form` | [Extra fields per domain extension](/en/docs/api/get-domain-order-id-form) | `domains:read` |
| `GET` | `/v1/domains` | [List domains (paginated)](/en/docs/api/get-domains) | `domains:read` |
| `GET` | `/v1/domains/@id/registrant` | [Read a waiting domain's registrant](/en/docs/api/get-domains-id-registrant) | `domains:registrant` |
| `PUT` | `/v1/domains/@id/registrant` | [Save a waiting domain's registrant](/en/docs/api/put-domains-id-registrant) | `domains:registrant` |
| `GET` | `/v1/domains/pending` | [Domains awaiting their dossier](/en/docs/api/get-domains-pending) | `domains:registrant` |
| `GET` | `/v1/registrants` | [Registrants used before](/en/docs/api/get-registrants) | `domains:registrant` |
| `GET` | `/v1/whois/@domain` | [Domain whois lookup (with a token)](/en/docs/api/get-v1-whois-domain) | `domains:read` |
| `GET` | `/whois/@domain` | [Domain whois lookup](/en/docs/api/get-whois-domain) | — |

## DNS

| Method | Path | Name | Scope |
| --- | --- | --- | --- |
| `GET` | `/v1/dns` | [List DNS zones](/en/docs/api/get-dns) | `dns:read` |
| `GET` | `/v1/dns/templates` | [DNS record templates](/en/docs/api/get-dns-templates) | `dns:read` |
| `GET` | `/v1/domain/@id/dns` | [Domain DNS records](/en/docs/api/get-domain-id-dns) | `dns:read` |
| `POST` | `/v1/domain/@id/dns` | [Add DNS record to domain](/en/docs/api/post-domain-id-dns) | `dns:write` |
| `PUT` | `/v1/domain/@id/dns/@index` | [Edit domain DNS record](/en/docs/api/put-domain-id-dns-index) | `dns:write` |
| `DELETE` | `/v1/domain/@id/dns/@index` | [Delete domain DNS record](/en/docs/api/delete-domain-id-dns-index) | `dns:write` |
| `GET` | `/v1/domain/@id/dns/types` | [Supported DNS record types](/en/docs/api/get-domain-id-dns-types) | `dns:read` |
| `GET` | `/v1/service/@service_id/dns` | [DNS zones of a service](/en/docs/api/get-service-service-id-dns) | `dns:read` |
| `POST` | `/v1/service/@service_id/dns` | [Add DNS zone](/en/docs/api/post-service-service-id-dns) | `dns:write` |
| `GET` | `/v1/service/@service_id/dns/@zone_id` | [DNS zone details](/en/docs/api/get-service-service-id-dns-zone-id) | `dns:read` |
| `PUT` | `/v1/service/@service_id/dns/@zone_id` | [Edit DNS zone](/en/docs/api/put-service-service-id-dns-zone-id) | `dns:write` |
| `DELETE` | `/v1/service/@service_id/dns/@zone_id` | [Delete DNS zone](/en/docs/api/delete-service-service-id-dns-zone-id) | `dns:write` |
| `GET` | `/v1/service/@service_id/dns/@zone_id/dnssec` | [Get DNS zone DNSSEC](/en/docs/api/get-service-service-id-dns-zone-id-dnssec) | `dns:read` |
| `PUT` | `/v1/service/@service_id/dns/@zone_id/dnssec` | [Turn DNS zone DNSSEC on or off](/en/docs/api/put-service-service-id-dns-zone-id-dnssec) | `dns:write` |
| `POST` | `/v1/service/@service_id/dns/@zone_id/records` | [Add DNS record](/en/docs/api/post-service-service-id-dns-zone-id-records) | `dns:write` |
| `PUT` | `/v1/service/@service_id/dns/@zone_id/records/@record_id` | [Edit DNS record](/en/docs/api/put-service-service-id-dns-zone-id-records-record-id) | `dns:write` |
| `DELETE` | `/v1/service/@service_id/dns/@zone_id/records/@record_id` | [Delete DNS record](/en/docs/api/delete-service-service-id-dns-zone-id-records-record-id) | `dns:write` |