.ong

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)

Command

command         = AddDomain
domain          = yourdomain.ong
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)

After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

There is no contact validation, but all registrants of .ONG domains must meet the registrant eligibility requirements.
Please be aware that .ONG domains are subject to audits for compliance with the Registration Policy. If a domain is selected for an audit, the Registrant will be required to provide documentation that establishes their .ONG status.

Domain Modification

(API Command reference » ModifyDomain)

Standard command

command = ModifyDomain
domain  = yourdomain.ong

Change of Registrant

Exception

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

All registrants have to be validated, wherefore a link is provided in the response of the ModifyDomain command similar to the response of the AddDomain command.

ICANN OwnerChange

• If the FoA mode is in place(default), the link will NOT be returned in the ModifyDomain response(DA will receive the response as shown for AddDomain). The verification link is included in the modification event after the losing and gaining registrant have approved the IRTP:
  • REGISTRAR:registrar1
    DATE:2018-12-18 11:19:51
    INDEX:1234
    CLASS:DOMAIN_MODIFICATION
    SUBCLASS:MODIFICATION_PENDING
    domain:example.ong
    jobid:1234
    cltrid:ABCDEFE3-87BA-4653-81D4-D51CE9C034C9
    svtrid:ABCDEF4B-AEA3-46B6-9887-FBD86AB59D24
    reason:ownerchange pending; The ownerchange is requested. To finish the ownerchange please follow the link and complete the verification process: https://www.ongood.ngo?d1=83f59b8f-416d-455c-a717-ba3a96b79139
    ownerchange_status:successful
    losing_registrant:P-ABC1
    gaining_registrant:P-ABC2
• StatusDomain response example:
  • [RESPONSE]
    code = 200
    description = Command completed successfully
    …
    property[x-ngo-verification-link][0] = https://www.ongood.ngo?d1=1234567890
    property[x-ngo-verification-until][0] = 2019-12-20 00:00:00

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.ong

Domain Transfer

(API Command reference » TransferDomain)

Command

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

Transfer Procedure

• The transfer is submitted to the registry and the losing registrar is automatically notified by them.
• The losing registrar sends an email to the owner (and optionally admin) contact, informing about the transfer; this may include options to approve and/or deny the transfer. If neither explicitly approved nor denied, the transfer will be automatically finalized after 5 days.

Transfer Notes

• A .ong domain transfer must be initiated with a so-called authorisation code, (auth-code) which can be obtained from the current registrar through the owner/admin contact of the domain.
• Ensure that your respective domain does not have a lock-status (clientTransferProhibited and/or serverTransferProhibited). This can be seen in WHOIS.
• If the domain has a client-side transfer lock, the owner can ask the current registrar to have the lock removed.

These procedures only apply for domain transfers between registrars. For internal transfers between resellers, please consult our documentation about internal transfers/usertransfers.

Auth-Codes

The format for auth info requires a minimum length of 8 characters and a maximum length of 32 characters.

Additionally, auth info must contain at least one of each of the following three character types:

• Alphabetic characters: a-z; A-Z
• Numeric characters: 0-9
• Special characters: !;<=$%?&@[()]*^+-,’-{.|/}:~

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.ong

Domain Extensions

X-NGO-VERIFICATION-LINK	Contains the verification link received after a successful registration request.
X-NGO-VERIFICATION-UNTIL	Contains the date until which the domain owner can validate his information. If the validation process is not finished until this date, the pending registration request will fail and the domain is released into public availability.

Domain Restrictions

Public Interest Registry has worked closely with the global NGO community to develop a validation process for NGOs and ONGs seeking to register .ong domains. Seven criterias are used to define an NGO or ONG for the purpose of validation:

1. Focused on acting in the public interest. Whether in support of education or health, the environment or human rights, members of the .ong community work for the good of humankind and/or the preservation of the planet and do not promote discrimination or bigotry.
2. Non-profit making/non-profit-focused entities. While many NGOs and ONGs engage in commercial activities or generate revenue in support of theirs missions, members of the .ong community do not recognize profits or retain earnings.
3. Limited government influence. Recognizing that many .ong organisations have important interactions with government, not least for reasons of funding (which may include receipt of some government funding in support of their programs,) members of the .ong community decide their own policies, direct their own activities and are independent of direct government or political control.
4. Independent actors. Members of the .ong community should not be political parties nor should be a part of any government. Participation in the work of a .ong is voluntary.
5. Active Organisations. Members of the .ong community are actively pursuing their missions on a regular basis.
6. Structured. Members of the .ong community, whether large or small, operate in a structured manner (e.g., under bylaws, codes of conduct, organizational standards, or other governancestructures.)
7. Lawful. Members of the .ong community act with integrity within the bounds of law. NGOs and ONGs participating as members in the .ong community must certify that they adhere to the above .ong Eligibility Criteria.

VALIDATION:

.ong: Changes to the Registration Validation Process

PIR implemented changes to the registration process for .ong domains that allow registrants to complete registration using self-certification instead of the former pre-validation process. Registrants must no longer leave the check-out flow to activate their domains.

Here are the changes:

• The domain name is live once registration is completed.
• The mandatory 2-year re-validation is no longer required.
• Resellers must add a checkbox for the self-certification during their checkout process with a link to the .ong Registration Policies:

I, the registrant, understand and agree to the .ONG Registration policies and certify that my organization meets the eligibility requirements therein.

Please note that it is not the responsibility of the registrar to store the self-certification information. It is the registrant’s responsibility to determine whether the domain name registration infringes or violates someone else’s rights. It is also the registrant’s responsibility to determine whether the domain name registration complies with the .ong registration policies.

PIR conducts random audits of .ong domain registrations and reserves the right to cancel, transfer or modify a domain name in accordance with their policies.

BUNDLED REGISTRATION:

• Please note that the TLDs .ONG and .NGO are no longer included in one registration. On June 1st 2022, the responsible registry has separated .NGO and .ONG domains. Since then, registrants are able to register .NGO and .ONG domains separately.
  In addition, the registry has allocate new .ONG domains for all registrants of the .NGO and .ONG bundles which existed at that time.

Supported IDN Scripts

The following IDN scripts are supported by .ong.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.

German	DE
Spanish	ES

Get more information of “IDN tables”, which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.