CentralNic Reseller Homepage
CentralNic Reseller Homepage


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)
command = AddDomain
domain = yourdomain.ca
period = (INT)
ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)
  • If >>X-CA-LEGAL-TYPE<< is set to >>CCT<< or >>RES<< then the owner contact and admin contact need to be the same.
  • If >>X-CA-LEGAL-TYPE<< is set to >>TDM<< then the owner contact must also contain the trademark number within the organization value (organization: Organization name - Trademark / Company Inc. - TMA123456)
  • If >>X-CA-LEGAL-TYPE<< is set to >>CCO<< then the owner contact organization name must contain one of the following words or combination of words:
    • (nfp)
    • (nfp/osbl)
    • (osbl)
    • (osbl/nfp)
    • bank
    • banque
    • caisse de credit
    • caisse d'economie
    • caisse d'epargne
    • caisse populaire
    • compagnie
    • company
    • coop
    • cooperation
    • cooperative
    • cooprix
    • corp
    • corp.
    • corporation
    • credit union
    • federation de societes mutuelles d'assurance
    • federation of mutual insurance associations
    • fideicommis
    • fiducie
    • inc
    • inc.
    • incorporated
    • incorpore
    • limited
    • limitee
    • ltd
    • ltd.
    • lte
    • lte.
    • ltee
    • ltee.
    • mutual benefit association
    • mutual insurance association
    • s.a.
    • s.a.r.f.
    • s.c.c.
    • savings union
    • societe commerciale canadienne
    • societe de fiducie
    • societe de secours mutuels
    • societe d'entraide economique
    • societe d'epargne
    • societe mutuelle d'assurance
    • societe par actions
    • trust

Domain Modification

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

Change of registrant

command = ModifyDomain
domain = yourdomain.ca
ownercontact0 = (CONTACT)

Domain Renewal

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

Domain Deletion

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

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain = yourdomain.ca
action = REQUEST
auth = (TEXT)

Auth Codes

The Authorisation Code of a .CA domain may have a length from 6 to 16 characters and may consist of the following characters: a - z, A - Z,0 - 9'

Domain Restore

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

Domain Extensions

ABO Aboriginal Peoples indigenous to Canada
ASS Canadian Unincorporated Association
CCO Corporation (Canada or Canadian province or territory)
CCT Canadian citizen
EDU Canadian Educational Institution
GOV Government or government entity in Canada
HOP Canadian Hospital
INB Indian Band recognized by the Indian Act of Canada
LAM Canadian Library, Archive or Museum
LGR Legal Rep. of a Canadian Citizen or Permanent Resident
MAJ Her Majesty the Queen
OMK Official mark registered in Canada
PLT Canadian Political Party
PRT Partnership Registered in Canada
RES Permanent Resident of Canada
TDM Trade-mark registered in Canada (by a non-Canadian owner)
TRD Canadian Trade Union
TRS Trust established in Canada
If 1, the domain name is a registered trademark

Domain Restrictions

  • The Owner and Admin-Contact must match the Canadian Presence Requirements (CPR).
  • For contacts located in Canada or the United States of America, the state parameter becomes mandatory.

IDN Information

  • It is now possible for French .ca domain names to be spelled with the language’s full range of characters and ligatures: é, ë, ê, è, â, à, æ, ô, œ, ù, û, ü, ç, î, ï, ÿ.
  • One of the most important developments by CIRA is the creation of a bundling policy that removes the necessity to register every special-character variant of an existing .ca domain. Whoever registers, or has already registered, a specific domain, is automatically granted an exclusive right to register all of its variants, but is under no obligation to do so. For example, only the owner of cira.ca will have the right to register cïra.ca and cîra.ca. The ownercontact has to be the same for all of the domains which belong to a bundle.

We domains