5 Domains API: How to retrieve TLD specific customer additional data

This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Zones API methods. To get more information about our API in general, please use our documentation portal as your reference.

 

In the previous article, we have covered additional domain fields that are required by some domain registries for a given TLD.

 

Apart from domain-specific attributes there also can exist customer(handle) specific data. For the very purpose of requesting those fields, one can utilize the following endpoint: 

Entering Geo Fence iconUse the endpoint path below. The base URL is determined by both the target environment and the API version.

GET {base_url}/domains/additional-data/customers

 

REQUEST VALUES

Name Type Description
domain.name string  Optional.
domain.extension string  Required.

REQUEST EXAMPLE

curl -X GET \
'https://api.openprovider.eu/v1beta/domains/additional-data/customers/?domain.extension=ru' \
-H 'Authorization: Bearer eca82663f*******76d063d8f6196'

RESPONSE EXAMPLE

{
"code": 0,
"desc": "",
"data": [
{
"name": "company_name_cyrillic",
"description": "Company name in Cyrillic",
"required": false,
"type": "text"
},
{
"name": "company_name_latin",
"description": "Company name in Latin",
"required": false,
"type": "text"
},
{
"name": "first_name_cyrillic",
"description": "First name in Cyrillic",
"required": false,
"type": "text"
},
{
"name": "first_name_latin",
"description": "First name in Latin",
"required": false,
"type": "text"
},
{
"name": "last_name_cyrillic",
"description": "Last name in Cyrillic",
"required": false,
"type": "text"
},
{
"name": "last_name_latin",
"description": "Last name in Latin",
"required": false,
"type": "text"
},
{
"name": "middle_name_cyrillic",
"description": "Middle name in Cyrillic",
"required": false,
"type": "text"
},
{
"name": "middle_name_latin",
"description": "Middle name in Latin",
"required": false,
"type": "text"
},
{
"name": "passport_issue_date",
"description": "Passport issue date",
"required": false,
"type": "text"
},
{
"name": "passport_issuer",
"description": "Passport issuer",
"required": false,
"type": "text"
},
{
"name": "passport_series",
"description": "Passport series",
"required": false,
"type": "text"
},
{
"name": "passport_number",
"description": "Passport number",
"required": false,
"type": "text"
},
{
"name": "tax_payer_number",
"description": "Tax payer number",
"required": false,
"type": "text"
},
{
"name": "mobile_phone_number",
"description": "Mobile phone number with SMS",
"required": false,
"type": "text"
},
{
"name": "postal_address_cyrillic",
"description": "Postal address",
"required": false,
"type": "text"
},
{
"name": "legal_address_cyrillic",
"description": "Legal address",
"required": false,
"type": "text"
},
{
"name": "birth_date",
"description": "Birth date is required",
"required": false,
"type": "text"
},
{
"name": "is_private_enterpreneur",
"description": "Whether the contact is the private enterpreneur.",
"required": false,
"type": "check"
}
]
}

RESPONSE VALUES

Name Type Description
name string Name of the field
required   Whether the field is mandatory or optional
type   Field type, e.g. text, check, select, multi-select
options   Possible values & value descriptions
description   Description of the field

Was this article helpful?
Additional questions? Submit a request