TLD Data
Helpful Links
The tld_data associative array contains additional information that is required by some registries, such as the residency of the registrant. For instance, .AU domains require eligibility information to demonstrate Australian presence and this information is provided within the tld_data associative array, under au_registrant_info.
The allowed values for tld_data are:
- au_registrant_info—Eligibility requirements for .AU registrants.
- br_register_number—Legal Brazilian identifier.
- ipr_data—Sponsored Community information associated with .XXX domains.
- it_registrant_info—Regional presence requirements for .IT domains.
- nexus —American presence requirements for .US domains.
- professional_data—The professional designation information that is associated with the .PRO domain.
- registrant_extra_info—Additional parameters that are required by various domain registries. See below for specific requirements for each TLD.
- ie_cro_number— Irish Companies Registration Office number. Requirement for .IE domains.
The tld_data information is used by the following commands: sw_register, modify domain, get domain, get_order_info, and trade domain (.FR only).
.AERO
Registration of .AERO domains is restricted to members of the aviation community such as airlines, airports, and qualifying companies and individuals.
To prove that they meet the requirements, registrants must provide an Eligibility and Name Selection (ENS) ID and password, which can be obtained by applying to the registry through this site: https://information.aero/registration
Parameters within the registrant_extra_info associative array are described below.
| Parameter name | Definition/Value | sw_register (request) |
|---|---|---|
| aero_ens_id | Eligibility and Name Selection (ENS) identifier | Required |
| aero_ens_password | Eligibility and Name Selection (ENS) password | Required |
.AU .ASN.AU .COM.AU .ID.AU .NET.AU .ORG.AU
For more information please reference: .AU domain policies.
Parameters within the au_registrant_info associative array are described below.
Parameter name | Definition/Value | sw _ register (request) | get domain (response) | get_order_info (response) |
|---|---|---|---|---|
eligibility_id | The identifier of the eligibility document.
| Required for .ASN.AU, .COM.AU .NET.AU, .ORG.AU Required for .AU if eligibility_type = Organization
| Always returned | Returned if submitted in the order |
eligibility_id_type | The Eligibility ID type. The allowed values depend on the eligibility_type specified. Allowed value for Charity is ABN. Allowed value for Club is ABN. Allowed value for
Allowed value for Non- profit Organization is ABN. Allowed value for Trade Union is OTHER. Allowed value for Companyis ACN or ABN. Allowed value for Sole Trader is ABN. Allowed value for Trademark Owner is TM. Allowed value for Pending Trademark Owner is TM. Allowed value for Partnership is ABN. | Required for .ASN.AU, .COM.AU .NET.AU, .ORG.AU Required for .AU if eligibility_type = Organization | Always returned | Returned if submitted in the order |
eligibility_name | The name on the eligibility ID document. | Required for .ASN.AU, .COM.AU .NET.AU, .ORG.AU, and .AU Required for .AU if eligibility_type = Organization | Returned if submitted in the order | Returned if submitted in the order |
eligibility_type | The reason that the registrant is eligible for the domain name. The eligibility_type must correspond to the eligibility_name. For example, if the registrant is using their company name to register the domain, then their eligibility_type is Company. Allowed values for .ASN.AU and .ORG.AU domains are: Charity Allowed values for .COM.AU and .NET.AU domains are: Company Allowed value for .ID.AU domains is Citizen/Resident Allowed Value for .AU is | Required for .ASN.AU, .COM.AU .NET.AU, .ORG.AU, .ID.AU, and .AU | Always returned | Always returned |
policy_reason | The name on the eligibility ID document. Indicates the reason the registrant is entitled to the domain name. Allowed values are:
| Required for .ASN.AU, .COM.AU, .NET.AU, and .ORG.AU Required for .AU if eligibility_type = Organization | Returned if submitted in the order | Returned if submitted in the order |
registrant_id | The registrant identifier. Must correspond to the registrant_id_type value (that is, the ABN or ACN),
| Required if Required for .AU if eligibility_type = Organization | Always returned | Always returned |
registrant_id_type | The Registrant ID type. Allowed values are:
| Required for .ASN.AU, .COM.AU, .NET.AU, and .ORG.AU Required for .AU if eligibility_type = Organization | Always returned | Always returned |
registrant_name | The legal entity such as a company, incorporated association, government agency or individual person. Cannot be a registered business name or trademark. | Required for .ASN.AU, .COM.AU .NET.AU, .ORG.AU, ID.AU, and .AU | Always returned | Always returned |
priority_contact_id | Registrants wishing to obtain a license for a .AU domain will have to submit this value if there is an existing 3rd level domain with the same name. This information can be obtained from auDA via the provided Priority Status Tool | Required for all 2nd level .AU domains if there is an existing 3rd level domain registered with the same name. | Returned if submitted in the order | Returned if submitted in the order |
priority_auth_info | Registrants wishing to obtain a license for a .AU domain will have to submit this value if there is an existing 3rd level domain with the same name. This information can be obtained from auDA via the provided Priority Status Tool | Required for all 2nd level .AU domains if there is an existing 3rd level domain registered with the same name. | Returned if submitted in the order | Returned if submitted in the order |
.CA
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw_register (request) | trade domain (request) | get domain (response) | get_order_info (response) |
|---|---|---|---|---|---|
legal_type | legal_type is required for both transfers and new registrations. Possible values are as follows
Please note: | Required | Required | Returned if applicable and is_success = true | Returned if is_success = true |
.CL
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get_order_info (response) |
|---|---|---|---|---|---|
id_card_number | The number of the individual's identity card. | Optional: can be submitted when registrant_ type = individual | Optional: can be submitted when registrant_ type = individual | Returned if applicable and is_success = true | Returned if applicable and is_success = true |
registrant_type | The entity type of registrant. | Required | Required | Returned if | Returned if |
registrant_vat_id | Value Added Tax registration number. | Optional: can be submitted when registrant_ type = organization | Optional: can be submitted when registrant_ type = organization | Returned if applicable and is_success = true | Returned if applicable and is_success = true |
.COM.AR .PT .COM.PT
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
id_card_number | The number of the individual's identity card. | Required when | Required when | Returned if | Returned if |
registrant_type | The entity type of registrant. | Required | Required | Returned if | Returned if |
tax_number | The number used for tax purposes. | Required | Required | Returned if | Returned if |
.COM.BR
Parameters within the tld_data associative array are described below.
Parameter name | name Definition/Value | sw _ register (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|
br_register_number | The Brazilian legal identifier. For organizations, this is the SNPJ (Business Identifier/Cadastro Nacional de Pessoa Juridica) For individuals, this is the CPF (Individual Tax Number/Cadastro de Pessoa Fisica) | Required | Returned if | Returned if |
.COOP
Registration of .COOP domains is restricted to cooperatives and related organizations.
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | modify domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
coopverification code | The coop verification code (CVC) is issued by dotCoop, and proves that the registrant is eligible to register the domain name. | Required | Required | Returned if | Returned if |
.ES
Registration of a .es domain requires validation by identification number ( in most cases an NIF or NIF number)
If registrant_extra_info is not provided in the API, or the es_id_type='other', the default values which will be provided to the registry are as follows:
- EsTipoIdentificacion => 0 (other)
- EsIdentificacion => "111111"
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Obligation | Definition/Value | sw_register | get_order_info |
|---|---|---|---|---|
es_id_type | Required. | Possible values include: | Required. | Returned if
|
es_id_number | Required if es_id_type is NIF or NIE | The NIE or NIF number. | Required. | Returned if
|
.EU
As of October 19th 2019, EU Citizens (Natural Persons) situated outside the EU must specify an EU country of citizenship
Parameter name | Obligation | sw_register | modify | update_contacts |
|---|---|---|---|---|
country_of_citizenship | Allowed Values AT | Required if Owner Contact is Blank & Owner Country is not in EU. | Required if Owner Contact is Blank & Owner Country is not in EU. | Required if Owner Contact is Blank & Owner Country is not in EU. |
.DE
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw_register (request) | get domain (response) | get_order_info (response) |
|---|---|---|---|---|
registrant_type | The entity type of registrant. Allowed values are individual or organization. | Required | Returned if | Returned if |
.DK
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw_register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
registrant_type | The entity type of Allowed values are individual or organization. | Required | Required | Returned if | Returned if |
registrant_vat_id | Value Added Tax | Required when registrant_ type = organization | Required when | Returned if is_success = true and type = organization | Returned if is_success = true and type = organization |
.FI .MY .SG
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw_register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
id_card_number | The number of the | Required when registrant_ type = organization | Required when registrant_ type = organization | Returned if | Returned if |
registrant_type | The entity type of Allowed values are individual or organization. | Required | Required | Returned if | Returned if |
registration_number | The business number of the | Required when | Required when | Returned if | Returned if |
date_of_birth | .FI Only | Required when registrant_type = individual | Required when registrant_type = individual | Returned if type = all_info and is_success = true | Returned if is_success = true |
.FR
.FR domains are available to any individuals and organizations located in the European Union, Switzerland, Norway, Iceland, or Liechtenstein. Individuals must reside within one of the qualifying countries; organizations must have their registered or main office located in a qualifying country; therefore, when registering or transferring .FR domains, you must provide additional residency information.
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw _ register (request) | get_order_info (response) | trade domain (request) |
|---|---|---|---|---|
registrant_type | The entity type of registrant. Allowed values are individual and organization. | Required | Always returned | Required |
registrant_vat_id | The Value Added Tax (VAT) number of the organization. | Optional, but recommended for organizations located in France | Returned if submitted in the order | Optional, but recommended for organizations located in France |
siren_siret | The 9 digit SIREN code or the 14 digit SIRET code that is used to identify the business for tax reasons. | Optional, but recommended for organizations located in France | Returned if submitted in the order | Optional, but recommended for organizations located in France |
trademark_number | The organization's trademark registrationnumber,if applicable. | Optional, but recommended for organizations located in France | Returned if submitted in the order | Optional, but recommended for organizations located in France |
.HK
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
date_of_birth | The registrant's | Required when registrant_ type = individual | Required when registrant_ type = individual | Returned if is_success = true and registrant_ type = individual | Returned if is_success = true and registrant_ type = individual |
id_card_number | The number of the | Required when registrant_ type = individual | Required when registrant_ type = individual | Returned if | Returned if |
registrant_type | The entity type of | Required | Required | Returned if | Returned if |
registration_number | The business number of the organization. | Required when registrant_ type = organization | Required when registrant_ type = organization | Returned if | Returned if |
.HU .CO.HU
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
id_card_number | The number of the individual's identity card | Required when registrant_ type = individual | Required when registrant_ type = individual | Returned if is_success = true and registrant_type = individual | Returned if is_success = true and registrant_type = individual |
registrant_type | The entity type of registrant. Allowed values are individual or organization. | Required | Required | Returned if | Returned if |
registrant_vat_id | Value Added Tax registration number. | Required when | Required when | Returned if | Returned if |
.IL
For more information, please see the OpenSRS Domain Policies .IL documentation.
.IT
Parameters within the it_registrant_info associative array are described below.
Parameter name | Definition/Value | sw _ register (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|
entity_type | The legal entity type of registrant. Allowed values are:
| Required | Always returned | Always returned |
nationality_code | The 2-digit ISO 3166-1 code that identifies the Registrant's nationality. If entity_type = 1, nationality or owner's country or both must be an EU country. If entity_type = 2-6, this value must be IT. If entity_type = 7, this value must match owner's country and must be an EU country other than IT.
| Optional | Returned if submitted in order | Returned if submitted in order |
reg_code | An identifying number, usually the VAT or Codice Fiscale (numeric tax code). The value that you need to enter depends on the entity type of the registrant. Italian citizens must enter their Codice Fiscale. Non Italians not living in Italy can enter a document number. Italian companies, freelancers, and other subjects must enter their 11 digit VAT number or tax identification number. Italian non-profit organizations must enter their VAT number or tax identification number. Non Italian entities other than persons (organizations, freelancers, companies, etc.) may enter their VAT number. | Required | Always returned | Always returned |
.JOBS
Registration of .JOBS domains is restricted to those who are involved in Human Resource management. To be eligible, registrants must be a member of the Society for Human Resource Management (SHRM) or involved in HR practices that meet any of the following criteria:
- Possess salaried-level human resource management experience.
- Are certified by the Human Resource Certification Institute.
- Are supportive of the SHRM Code of Ethical and Professional Standards in Human Resource Management, as amended from time to time.
Consequently, when registering a .JOBS domain, registrants must complete some additional information.
For more information on the restrictions and policies regarding .JOBS registrations, see http://www.policy.jobs/
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw_register (request) | modify domain (request) | get domain (response) |
|---|---|---|---|---|
jobs_admin_type | Indicates whether the registrant is the Admin contact. Allowed values are Yes or No | Required | Required | Always returned |
jobs_association_member | Indicates whether the registrant is a member of SHRM. Allowed values are Yes or No | Required | Required | Always returned |
jobs_industry_type | The type of business. | Optional | Optional | Returned if submitted in order |
jobs_title | The registrant's job title. | Optional | Optional | Returned if submitted in order |
jobs_website | The URL for the registrant's company. | Required | Required | Always returned |
.LAW .ABOGADO
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) |
|---|---|---|
qli_accreditation_id | Qualified Lawyer's Accreditation ID | Required |
qli_accreditation_body | Qualified Lawyer's Accreditation Body | Required |
qli_jurisdiction_country | Accreditation Jurisdiction Country. Allowed value is an uppercase 2-letter ISO country code. Must be one of the following: AD, AE, AF, AG, AI, AL, AM, AN, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BF, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BV, BW, BX, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, EU, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, OT, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UK, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, YE, YT, ZA, ZM, ZR, ZW | Required |
qli_jurisdiction_state | Accreditation Jurisdiction State/Province | Optional |
qli_accreditation_year | Qualified Lawyer's Accreditation Year. Allowed value is 4 digits. | Required |
.LV .COM.LV
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw_register (request) | modify domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
id_card_number | The number of the individual's | Required when registrant_ type = individual | Required when registrant_ type = individual | Returned if is_success = true and registrant_ type = individual | Returned if is_success = true and registrant_ type = individual |
registration_number | The business number of the organization. | Required when registrant_type = organization | Required when registrant_type = organization | Returned if is_success = true and registrant_ type = organization | Returned if is_success = true and registrant_ type = organization |
registrant_type | The entity type of registrant. | Required | Required | Returned if
| Returned if
|
registrant_vat_id | The Value Added Tax (VAT) number of the organization | Required when registrant_type = organization | Required when registrant_type = organization | Returned if
| Returned if
|
.MX .COM.MX .CO.ZA
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | modify domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
registrant_type | The entity type of registrant. Allowed values are: | Required | Required | Returned if
| Returned if
|
.NO
Parameters within the registrant_extra_info associative array are described below.
| Parameter name | Definition/ Value | sw_ register (request) | trade domain (request) | get domain (response) | getorder info (response) |
|---|---|---|---|---|---|
| registration_number | Norwegian company register number. This number can be verified [here].(https://w2.brreg.no/enhet/sok/index.jsp). | Required | Required | Returned if is_success = true | Returned if is_success = true |
.PM .RE .TF .WF .YT
Parameters within the registrant_extra_info associative array are described
below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
registrant_type | The entity | Required | Required | Returned if
| Returned if
|
registrant_vat_id | The Value | Optional. May
| Optional. May
| Returned if
| Returned if
|
registration_number | The business | Optional, but | Optional, but | Returned if
| Returned if
|
trademark_number | The number | Optional but
| Optional but
| Returned if
| Returned if
|
.PRO
In order to register a .PRO domain name, the registrant must belong to an
accredited profession.
Parameters within the professional_data associative array are described
below.
Parameter name | Definition/Value | sw _ register (request) | modify domain (request) | get domain (response) | get_order _ info (response) |
|---|---|---|---|---|---|
authority | The name of the authority from which the registrant receives their professional credentials. | Optional | Optional | Returned if submitted | Returned if submitted |
authority_website | The URL to an online | Optional | Optional | Returned if submitted | Returned if submitted |
license_number | The license number of the registrant's credentials, if applicable. | Optional | Optional | Returned if submitted | Returned if submitted |
profession | The stated profession of | Required | Required | Always | Always |
.RO .COM.RO
Parameters within the registrant_extra_info associative array are described
below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
id_card_number | The number of | Required when
| Required when
| Returned if is_success = true and
| Returned if
|
registration_number | The business number of the organization. | Required when registrant_type = organization | Required when | Returned if
| Returned if
|
registrant_type | The entity type of | Required | Required | Returned if | Returned if |
registrant_vat_id | The Value Added Tax | Required when
| Required when
| Returned if
| Returned if
|
.RU
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition /Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
date_of_birth | The registrant's | Required when | Required when
| Returned if is_success = true and registrant_type = | Returned if is_success =true and registrant_type = |
id_card_authority | The name of the issuer. | Required when | Required when | Returned if is_success = true and registrant_type = | Returned if is_success = true and
|
id_card_issue_date | The date that the ID card was issued, in the format | Required when registrant_type = | Required when registrant_type = | Returned if
| Returned if is_success = true and registrant_type = |
id_card_number | The number of the | Required when
| Required when
| Returned if
| Returned if
|
place_of_birth | The city in which the | Required when
| Required when
| Returned if
| Returned if
|
registrant_type | The entity type of registrant. Allowed values are individual | Required | Required | Returned if is_success = true | Returned if is_success = true |
.SE .NU
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/ Value | sw _ register (request) | trade domain (request) | get domain (response) | get order info (response) |
|---|---|---|---|---|---|
id_card_number | The number of | Required when registrant_type = | Required when
| Returned if is_success = true and registrant_type = | Returned if is_success = true and registrant_type = |
registrant_type | The entity
| Required | Required | Returned if | Returned if |
registrant_vat_id | The Value | Required when
| Required when
| Returned if is_success = true and registrant_type = organization | Returned if is_success = true and registrant_type = organization |
registration_number | The business | Required when
| Required when
| Returned if is_success = true and
| Returned if is_success = true and
|
.TRAVEL
In order to register a .TRAVEL domain name, the registrant must be a participant in the travel and tourism industry, and they must have a Unique Identifying Number (UIN).
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw _ register (request) | modify domain (request) | get domain (response) | get_order _ info (response) |
|---|---|---|---|---|---|
travel_uin | The Unique Identifying | Optional | Optional | Returned if | Returned if |
.UK .CO.UK .ORG.UK
Parameters within the registrant_extra_info associative array are described below.
Parameter name | Definition/Value | sw _ register (request) | modify domain (request) | get domain (response) | get_order _ info (response) |
|---|---|---|---|---|---|
registrant_type | CRC | Required | Required | Required | Required |
registration_number | Organization ID issued by the government. | registrant type = | registrant type = | registrant type = | registrant type = |
trading_name | The trading name of the organization. | Required if registrant type = LTD | Required if registrant type = LTD | Required if registrant type = LTD | Required if registrant type = LTD |
.UK registrant_type
| Registrant Type Code | Definition/Value |
|---|---|
| CRC | UK Corporation by Royal Charter |
| FCORP | Non-UK Corporation |
| FIND | Foreign Individual |
| FOTHER | Non-UK Entity that does not fit another category |
| GOV | Uk Government Body |
| IND | Individual |
| IP | UK Industrial/Provident Registered Company |
| LLP | UK Limited Liability Partnership |
| LTD | UK Limited Company |
| OTHER | UK Entity that does not fit another category |
| PLC | UK Public Limited Company |
| PTNR | UK Partnership |
| RCHAR | UK Registered Charity |
| SCH | UK School |
| STAT | UK Statutory Body |
| STRA | UK Sole Trader |
.US
Parameters within the nexus associative array are described below.
Parameter name | Definition/Value | sw _ register (request) | modify domain (request) | get domain (response) | get_order _ info (response) |
|---|---|---|---|---|---|
app_purpose | A description of the
| Required | Required | Always | Always |
category | A description of the
| Required | Required | Always | Always |
validator | The domain owner's | Required if category = | Required if category = | Returned if category = | Returned if category = |
.XXX
.XXX domains are available to those within the adult entertainment industry who are members of the Sponsored Community (SC).
Updated 16 days ago
