.fi

API commandsExtensionsRestrictionsIDN

API Commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Exception

command         = AddDomain
domain          = yourdomain.fi
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)
X-FI-COMPANY-REG-ID = (TEXT)(only organizations)
X-FI-PERSONAL-ID    = (TEXT)(only natural persons)
X-FI-BIRTHDATE      = (DATE)(mandatory for registrants outside Finland)
X-FI-CONTACT-TYPE = (INT)(optional)

Please advise your .fi registrants that they should consult registers before the domain registration in order to check whether the .fi domain name they are about to register is a protected name or trademark owned by another party in Finland or the EU. Consulting the registers is simple and free of charge. You can find links to all registers here.

• The tech and billing contact must NOT be a natural person but rather a company/organization, respectively a contact of the reseller.

Domain Modification

(API Command reference » ModifyDomain)

Standard command

command = ModifyDomain
domain  = yourdomain.fi

In order to change the owner of a .fi domain you have to a)request an authcode for the domain and then b)request a trade.

Request an Authcode for the Domain

Exception

command              = TradeDomain
domain               = yourdomain.fi
X-FI-REQUESTAUTHCODE = 1

• Request authcode for the domain with the special parameter X-FI-REQUESTAUTHCODE
• The current domain holder will receive an email from the registry containing the authcode.

Change of Registrant

Exception

command              = TradeDomain
domain          = yourdomain.fi
ownercontact0   = (CONTACT)
auth    = .......
X-FI-COMPANY-REG-ID = (TEXT)(only organizations)
X-FI-PERSONAL-ID    = (TEXT)only natural persons)
X-FI-BIRTHDATE      = (DATE)(mandatory for registrants outside Finland)

• Request the trade to the new domain holder with the TradeDomain command.
• You have to state the contact handle of the new owner. Please always create a new contact handle and do not use modified contact handles.
• The trade of the domain will be processed instantly.
• A .fi domain will not be automatically renewed upon a trade

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.fi
period     = (INT)
expiration = (INT)

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.fi

Domain Transfer

(API Command reference » TransferDomain)

Standard command

command = TransferDomain
domain = yourdomain.fi
action = REQUEST
auth = (TEXT)

Transfer Out: Request an Authcode for the Domain

Exception

command              = TransferDomain
domain               = yourdomain.fi
X-FI-REQUESTAUTHCODE = 1

• To transfer the domain to another registrar (TransferOUT) it is necessary to request an authcode from the registry
• The authcode will be shown in the response

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.fi

Domain Extensions

X-FI-CONTACT-TYPE	* Optional * Default values are 0 and 1 (set automatically if the parameter is not specified). * Example: X-FI-CONTACT-TYPE will be set to 1 if X-FI-COMPANY-REG-ID is used. 0 Private person 1 Company 2 Corporation 3 Institution 4 Political party 5 Township 6 Government 7 Public community
X-FI-REQUESTAUTHCODE	1

Domain Extensions for Natural Persons

X-FI-BIRTHDATE	YYYY-MM-DD Mandatory for registrants outside Finland
X-FI-PERSONAL-ID	Finnish Personal Identity Number

Domain Extensions for Organisations or Companies

X-FI-COMPANY-REG-ID	Local business Entity (registered at the Finnish Trade Register ( https://tietopalvelu.ytj.fi/yrityshaku.aspx?kielikoodi=3 ) or a corporation within the Finnish republic) ID-Code Business ID or Reg.Number for non Finnish entities

Domain Restrictions

• Although there are no more restrictions for .fi registrations, the registry still demands several extensions

• DNSSEC does not support SHA-1

• The DNSSEC signing algorithm 5 - RSASHA1 (RSA/SHA-1) WILL NO LONGER BE SUPPORTED as of 13 September 2020. .Fi domain names using Algorithm 5 keys will continue to operate normally and Traficom will not remove records currently in use from the .fi root.

  After the change, no new RSA/SHA-1 keys can be added. This means that another permitted algorithm must be used once the current keys are rotated out.

  Why this change is being made:

  The RSA/SHA-1 Algorithm is no longer considered secure.

  At a later time, Algorithm 7 will also be phased out. We therefore recommend to discontinue its use. Once the change has taken effect, the supported DNSSEC signing algorithms are the following:

  • Algorithm 7 - RSASHA1-NSEC3-SHA1

  • Algorithm 8 - RSASHA256 (RSA/SHA-256)

  • Algorithm 10 - RSASHA512 (RSA/SHA-512)

  • Algorithm 13 - ECDSAP256SHA256 (ECDSA Curve P-256 with SHA-256)

  The adoption of Algorithm 15 - Ed25519 is currently being considered and support for it will be available in the future.

IDN Information

The national characters å, ä and ö.