CentralNic Reseller Homepage
CentralNic Reseller Homepage

.ie

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.ie
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)
X-IE-LANGUAGE = (EN|FR)(optional)
X-IE-CONTACT-TYPE = (COM|CHA|OTH)
X-IE-CRO-NUMBER = (TEXT)(optional, for companies)
X-IE-SUPPORTING-NUMBER = (TEXT)(optional, for charities)

Registrant documents are needed for the new registrant. First time registering a .ie domain, registrants are reviewed by the registry and a ticket is created in their system.

Ticket ID, ticket status and registrant validation status may be available immediately on AddDomain response extensions (and afterwards on StatusDomain response), depending on how fast the ticket is generated by the registry. If the ticket ID will not be available immediately, we will update it on StatusDomain response extensions, as soon as we receive it from the registry.

The registrant document(s) should be uploaded to https://www.myconnection.ie/, where the ticket ID is necessary. We will forward by email / event / POLL the list of accepted documents as well as other relevant information sent by the registry.

Domain Modification

(API Command reference » ModifyDomain)
Standard command
command = ModifyDomain
domain  = yourdomain.ie

Change of registrant

Exception
command         = TradeDomain
domain          = yourdomain.ie
ownercontact0   = (CONTACT)
X-IE-LANGUAGE = (EN|FR)(optional)
X-IE-CONTACT-TYPE = (COM|CHA|OTH)
X-IE-CRO-NUMBER = (TEXT)(optional, for companies)
X-IE-SUPPORTING-NUMBER = (TEXT)(optional, for charities)

If the new registrant is a first-time registrant of a domain, the same rules apply as on AddDomain with a new registrant.

The registrant document(s) should be uploaded to https://www.myconnection.ie/, where the ticket ID is necessary. We will forward by email / event / POLL the list of accepted documents as well as other relevant information sent by the registry.

The ticket ID will also be available on StatusDomain response extensions, as soon as we receive it from the registry.

Domain Renewal

(API Command reference » RenewDomain)
Command
command    = RenewDomain
domain     = yourdomain.ie
period     = (INT)
expiration = (INT)

The registry has default AUTORENEW mode. You can also renew a domain explicitly before the expire date or you can set in RRPPRoxy the domain renewal mode or default renewal mode to AUTORENEW or RENEWONCE.

Domain Deletion

(API Command reference » DeleteDomain)
Command
COMMAND = DeleteDomain
DOMAIN = yourdomain.ie

Domain Transfer

(API Command reference » TransferDomain)
Exception
command = TransferDomain
domain  = yourdomain.ie
action  = request
auth    = .......

To transfer a .ie domain to a new .ie registrar, you only need an authorization code which can be requested from the current registrar.

Domain Restore

(API Command reference » RestoreDomain)
Command
command = RestoreDomain
domain  = yourdomain.ie

Domain Extensions

X-IE-CONTACT-TYPERegistrant/Owner type: Company/Charity/Other (Default = OTH)
X-IE-CRO-NUMBERCompanies Registration Office (CRO) number, used to automatic identify/review the registrant/owner having contact type Company
X-IE-LANGUAGELanguage the owner wishes to communicate with the registry (Default = EN)
X-IE-SUPPORTING-NUMBERCharity/Supporting number, used to automatic identify/review the registrant/owner having contact type Charity
X-IE-TICKET-IDTicket ID necessary when submitting documents of new registrants on https://www.myconnection.ie/
X-IE-TICKET-STATUSStatus of the ticket with above ID; possible values: Awaiting Agent | Awaiting User | Resolved Accepted | Resolved Rejected | Resolved Expired | Resolved Cancelled
X-IE-VALIDATION-STATUSStatus of registrant's validation; possible values: Unverified | Pending | Validated | Failed | Cancelled

Domain Restrictions

  • Pre-configured name servers are mandatory!
  • Corporate Name
    • An incorporated company can register a domain name to reflect their corporate name. A company can register multiple different domain names in this category. Only a company can have a corporate name and therefore only a company can register a domain name in this category.
    • Requirements:
    • A company applying under this category need only include their company number in the application.
    • If the company is incorporated outside of Ireland, specifically UK or US, the company number must be included in the application. All applicants from any other country must submit a copy of the company's certificate of incorporation.
    • Domain Options:
    • An applicant can add words to their registered company name to form a domain name.
    • An applicant can register domain names that have a reasonable connection with their business. In this case the IEDR deems a reasonable connection to be a product or service of the company. (Registration policy)
    • An abbreviation of the corporate name may be used instead of the full corporate name.
  • Registered Trade Mark Name
    • Any applicant with a Registered Trademark is eligible to apply under this category.
    • Requirements:
    • Irish, UK, US and Community trademarks need only supply their Trademark Number in the application.
    • For any other country Trademark a copy of the Trademark Certificate must be supplied.
    • Where the application is made on the basis of a pending TM application the Registry will require a copy of the TM application form and official filing receipt, along with a letter from the TM holder.
    • Where the applicant is a licensed user of the trademark, the applicant must provide a signed letter on headed paper from the trademark holder authorising the applicant to register and hold the corresponding .IE domain.
    • Domain Options:
    • The proposed domain name must correspond closely with the TM, but may include plurals, descriptors, or non-descriptive elements such as numbers or letters and may also differ in respect of signs, symbols or punctuation.
    • Important Note:
    • A CTM (Community Trade Mark) provides a connection to Ireland automatically.
    • A WIPO (World Intellectual Property Organisation) may include Ireland (IE) in it's trade mark listing, in which case, it will also serve as a connection to Ireland.
    • All other Trade Marks must also provide a connection to Ireland in order to be approved.
  • Registered Business Name
    • A Sole Trader, Company or Unincorporated Association who hold a registered business name can apply for a domain name under this category. (Note: If you trade under a name other than your own name, you must register it as a business with the CRO).
    • Requirements:
    • The applicant applying under this category need only include the RBN Number in the application.
    • Unless:
    • The RBN cannot be confirmed online. If the applicant holds a copy of the registered business name certificate or a copy of all pages of the application form stamped by the Companies Registration Office, these documents can be faxed to the Registry.
    • The RBN has been recently applied for. Applications will be accepted if the applicant can provide us with a copy of their customer receipt from the Companies Registrations Office. Alternatively they can provide us with the Submission Number printed on the receipt, which also must be verifiable online to be accepted.
    • The IEDR is aware that applicants within Northern Ireland do not have to register business names and in such instances the Registry may accept a VAT number or a signed letter on headed paper from an bank manager, firm of chartered accountant(s), registered auditor(s), tax consultant(s), where the tax advisor identification number is displayed on the letterhead, or solicitor(s) confirming that the company is currently trading, or has serious intention and commitment to trade shortly, under the business name that is specified. The letter must state the name of the company and that they are trading, or intend to trade, under the business name in question.
    • Domain Options:
    • An applicant can add words to their registered business name to form a domain name.
    • An applicant can register domain names that have a reasonable connection with their business. In this case the IEDR deems a reasonable connection to be a product or service of the registered business.
    • An abbreviation of the registered business name may be used instead of the full business name.
    • In all cases, the registrant must either reside within Ireland, or demonstrate a Real and Substantive Connection with Ireland (with the exception of those applying with a registered Community Trademark).

For registrant contacts located in the USA, United Kingdom & Northern Ireland and Ireland, the state (county) parameter becomes mandatory preferably submitted in ISO_3166-2 format!

Unfortunately, the registry does not support all county values. The following table contains the supported values depending on the country of origin:

  • United Kingdom & Northern Ireland:
    • Alderney, Avon, Bedfordshire, Berkshire, Borders, Buckinghamshire, Cambridgeshire, Central, Cheshire, Cleveland, Clwyd, Cornwall, Cumbria, Derbyshire, Devon, Dorset, Dumfries&Galloway, Durham, Dyfed, East Sussex, Essex, Fife, Gloucestershire, Grampian, Greater London, Greater Manchester, Guernsey, Gwent, Gwynedd, Hampshire, Hereford&Worcester, Hertfordshire, Highland, Humberside, Isle Of Man, Isle of Wight, Jersey, Kent, Lancashire, Leicestershire, Lincolnshire, Lothian, Merseyside, Mid Glamorgan, Middlesex, Norfolk, North Yorkshire, Northamptonshire, Northumberland, Nottinghamshire, Orkney, Oxfordshire, Powys, Scotland, Shetland, Shropshire, Somerset, South Glamorgan, South Yorkshire, Staffordshire, Strathclyde, Suffolk, Surrey, Sussex, Tayside, Tyne&Wear, Wales, Warwickshire, West Glamorgan, West Lothian, West Midlands, West Sussex, West Yorkshire, Western Isles, Wiltshire, Co. Antrim, Co. Amagh, Co. Derry, Co. Down, Co. Fermanagh, Co. Tyrone
  • Ireland
    • Co. Carlow, Co. Cavan, Co. Clare, Co. Cork, Co. Donegal, Co. Dublin, Co. Galway, Co. Kerry, Co. Kildare, Co. Kilkenny, Co. Laois, Co. Leitrim, Co. Limerick, Co. Longford, Co. Louth, Co. Mayo, Co. Meath, Co. Monaghan, Co. Offaly, Co. Roscommon, Co. Sligo, Co. Tipperary, Co. Waterford, Co. Westmeath, Co. Wexford, Co. Wicklow
  • USA
    • Alabama, Alaska, Arizona, Arkansas, California, Colorado, Connecticut, Delaware, District of Columbia, Florida, Georgia, Hawaii, Idaho, Illinois, Indiana, Iowa, Kansas, Kentucky, Louisiana, Maine, Maryland, Massachusetts, Michigan, Minnesota, Mississippi, Missouri, Montana, Nebraska, Nevada, New Hampshire, New Jersey, New Mexico, New York, North Carolina, North Dakota, Ohio, Oklahoma, Oregon, Pennsylvania, Rhode Island, South Carolina, South Dakota, Tennessee, Texas, Utah, Vermont, Virginia, Washington, West Virginia, Wisconsin, Wyoming

IDN Information

The following IDN charaters are supported: á, é, í, ó, ú

We domains
-