.ca

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.ca
period = (INT)
ownercontact0 = (CONTACT)
admincontact0 = (CONTACT)
techcontact0 = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0 = (NAMESERVER)
nameserver1 = (NAMESERVER)
X-CA-LEGAL-TYPE = (TEXT)
X-CA-TRADEMARK = 0|1

• 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

Exception

command = ModifyDomain
domain = yourdomain.ca
ownercontact0 = (CONTACT)
X-CA-LEGAL-TYPE = (TEXT)
X-CA-TRADEMARK  = 0|1

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.ca

Domain Transfer

(API Command reference » TransferDomain)

Command

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

command = RestoreDomain
domain  = yourdomain.ca

Domain Extensions

X-CA-LEGAL-TYPE

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

X-CA-TRADEMARK

0|1 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.
• Name servers for a .CA domain must have unique IP addresses if the host objects are subordinate of a .CA domain. For instance, the IP address for ns1.nameserver.ca must be different from the IP address for ns2.nameserver.ca.

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.