POST/v1/domain/order

Order domain

Create a standalone domain registration or transfer order. Check that the domain is available first (POST /v1/domain/lookup), otherwise the order may be cancelled.

API v1 · Updated 2026-10-21View .md

Call it through the gateway https://api.tino.vn/v1 with a token that has the domains:write scope; see Calling the Tino API.

Authentication

Send the token in the header Authorization:

Authorization: Bearer <token>

Tokens that can call it: app tokens (tinoat_, Sign in with Tino) or personal API tokens (tinopat_).

Scopes

domains:writeDomain management

Parameters

Body (JSON)

Name	Type	Required	Description
`name`	string	Optional	Domain name
`years`	string	Optional	Number of years
`action`	string	Optional	register\|transfer
`tld_id`	string	Optional	TLD id
`pay_method`	integer	Optional	Payment method ID
`epp`	string	Optional	EPP Transfer code, required when transfering some domains
`nameservers`	array	Optional	Optional array with 2 - 4 nameservers that you want to use
`registrant`	integer	Optional	Optional contact ID to use for registrant contact this domain
`admin`	integer	Optional	Optional contact ID to use for admin contact this domain
`tech`	integer	Optional	Optional contact ID to use for tech contact this domain
`billing`	integer	Optional	Optional contact ID to use for billing contact this domain
`data`	array	Optional	Addditional data required for some TLDs
`aff_id`	integer	Optional	Affiliate ID

Response

No live sample: the route changes real data or the test account has no data for it. The answer is a JSON object; errors follow the common shape in Calling the Tino API.

Error codes

Error code	Description
`401 · invalid_token`	The token is wrong, expired or revoked.
`403 · insufficient_scope`	The token lacks the domains:write scope.
`403 · ip_not_allowed`	A personal API token called from an IP outside its allow-list.

Business errors of a route usually come as HTTP 200 with {"error": ["<code>"]}; see common error codes.

1curl -X POST "https://api.tino.vn/v1/domain/order" \2 -H "Authorization: Bearer $TINO_TOKEN" \3 -H "Content-Type: application/json" \4 -d '{5 "name": "example.com",6 "years": "<years>",7 "action": "<action>",8 "tld_id": "<tld_id>",9 "pay_method": "<pay_method>",10 "epp": "<epp>",11 "nameservers": "<nameservers>",12 "registrant": "<registrant>",13 "admin": "<admin>",14 "tech": "<tech>",15 "billing": "<billing>",16 "data": "<data>",17 "aff_id": 5518}'

1import os2from tino_userapi import TinoClient34client = TinoClient(base_url="https://api.tino.vn/v1", token=os.environ["TINO_TOKEN"])5result = client.domains.order(name="example.com", years="<years>", action="<action>", tld_id="<tld_id>", pay_method="<pay_method>", epp="<epp>", nameservers="<nameservers>", registrant="<registrant>", admin="<admin>", tech="<tech>", billing="<billing>", data="<data>", aff_id=55)