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

<span>*This is a series of articles dedicated to demonstrating how to get acquainted with Openprovider Zones API methods.* </span> *To get more information about our API in general, please use our [documentation portal](http://docs.openprovider.com) as your reference.*

In the previous article, we have covered [additional domain fields](https://openprovider.help/books/api-plugins/page/4-domains-api-how-to-retrieve-tld-specific-data) 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 <span>requesting those fields, one can utilize the following endpoint:</span>

<div id="bkmrk-use-the-endpoint-pat">![Entering Geo Fence icon](https://openprovider.help/uploads/images/gallery/2026-08/embedded-image-at1iqg2t.png)Use the endpoint path below. The base URL is determined by both the target environment and the API version.  
  
</div><div id="bkmrk-get-%7Bbase_url%7D%2Fdomai">```
<span><strong>GET</strong> <a href="http://docs.openprovider.com/#operation/"><strong>{base_url}</strong></a>/domains/additional-data/customers</span>
```

</div><div id="bkmrk-request-values-name-"><details><summary>REQUEST VALUES</summary>

<table><tbody><tr><td>**<span>Name</span>**</td><td>**<span>Type</span>**</td><td>**<span>Description</span>**</td></tr><tr><td class="tg-0lax">domain.name</td><td class="tg-0lax">string</td><td class="tg-0lax"> **Optional.**</td></tr><tr><td class="tg-0lax">domain.extension</td><td class="tg-0lax">string</td><td class="tg-0lax"> **Required.**</td></tr></tbody></table>

</details>  
<div id="bkmrk-request-examplecurl-"><div><details><summary>REQUEST EXAMPLE</summary>

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

</details></div><details><summary>RESPONSE EXAMPLE</summary>

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

</details><div id="bkmrk-response-values-name"><details><summary>RESPONSE VALUES</summary>

<table><tbody><tr><td>**<span>Name</span>**</td><td>**<span>Type</span>**</td><td>**<span>Description</span>**</td></tr><tr><td>name</td><td>string</td><td>Name of the field</td></tr><tr><td><span>required</span></td><td>Whether the field is mandatory or optional</td></tr><tr><td><span>type</span></td><td>Field type, e.g. text, check, select, multi-select</td></tr><tr><td><span>options</span></td><td><span>Possible values &amp; value descriptions</span></td></tr><tr><td><span>description</span></td><td>Description of the field</td></tr></tbody></table>

</details></div></div></div>