CentralNic Reseller Homepage
CentralNic Reseller Homepage

.fi

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.

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)

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-REQUESTAUTHCODE1

Domain Extensions for natural persons

X-FI-BIRTHDATEYYYY-MM-DD

Mandatory for registrants outside Finland
X-FI-PERSONAL-IDFinnish Personal Identity Number

Domain Extensions for organisations or companies

X-FI-COMPANY-REG-IDLocal 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 ö.

We domains
-