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.

Guides

Domain registrant dossier

Domains

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

DNS

Method	Path	Name	Scope
`GET`	`/v1/dns`	List DNS zones	`dns:read`
`GET`	`/v1/dns/templates`	DNS record templates	`dns:read`
`GET`	`/v1/domain/@id/dns`	Domain DNS records	`dns:read`
`POST`	`/v1/domain/@id/dns`	Add DNS record to domain	`dns:write`
`PUT`	`/v1/domain/@id/dns/@index`	Edit domain DNS record	`dns:write`
`DELETE`	`/v1/domain/@id/dns/@index`	Delete domain DNS record	`dns:write`
`GET`	`/v1/domain/@id/dns/types`	Supported DNS record types	`dns:read`
`GET`	`/v1/service/@service_id/dns`	DNS zones of a service	`dns:read`
`POST`	`/v1/service/@service_id/dns`	Add DNS zone	`dns:write`
`GET`	`/v1/service/@service_id/dns/@zone_id`	DNS zone details	`dns:read`
`PUT`	`/v1/service/@service_id/dns/@zone_id`	Edit DNS zone	`dns:write`
`DELETE`	`/v1/service/@service_id/dns/@zone_id`	Delete DNS zone	`dns:write`
`GET`	`/v1/service/@service_id/dns/@zone_id/dnssec`	Get DNS zone DNSSEC	`dns:read`
`PUT`	`/v1/service/@service_id/dns/@zone_id/dnssec`	Turn DNS zone DNSSEC on or off	`dns:write`
`POST`	`/v1/service/@service_id/dns/@zone_id/records`	Add DNS record	`dns:write`
`PUT`	`/v1/service/@service_id/dns/@zone_id/records/@record_id`	Edit DNS record	`dns:write`
`DELETE`	`/v1/service/@service_id/dns/@zone_id/records/@record_id`	Delete DNS record	`dns:write`