Get list of GEO records - API Documentation

HTTP method

GET

URL

https://api.zilore.com/dns/v1/domains/{domain_name}/geo

Request parameters

Parameter	Description
domain_name	Domain name. Must conform to the standard. Names of national domains must be passed in Punycode format.

Additional parameters

Parameter	Description
offset	Omission of the stated number of records in the response
limit	Limit on the number of records returned
order_by	Sort parameter, accepts values: idn_record_name — Name of record in Unicode format record_type — Record type idn_record_value — Record value in Unicode format record_ttl — Maximum permitted time for record to be cached record_region — GEO-identifier of the record
order_param	Sort parameter, accepts values: asc — alphabetical order (A-Z) desc — reverse alphabetical order (Z-A)
search_text	Substring for search

For exact matching, you need to use the additional strict_search=yes parameter. To search by specific record type, use search_record_type=A/AAAA/CNAME/ALIAS.

Search is performed by name, value, ttl, type, and geo identifier (match any field)

Response fields

Parameter	Description
record_id	Record identifier
record_name	Name of record in Unicode format
record_status	Record status: enabled — Active disabled — Inactive
record_type	Record type: A — Establishes correspondence between a domain name/subdomain and its IPv4 address AAAA — Establishes correspondence between a domain name/subdomain and its IPv6 address CNAME — Establishes correspondence beteeem a subdomain and another domain name (cannot be used with a domain name directly) ALIAS — Establishes correspondence between a domain name/subdomain and another domain name (can be used without limitation)
record_value	Record value in Unicode format
record_ttl	Maximum permitted time for record to be cached
geo_region	GEO-identifier of the record
geo_full_region	Full name of GEO region
default_records	Array of records with the same name, by default, with fields: record_id — Record identifier record_value — Record value in Unicode format record_status — Record status (enabled\|disabled)
is_failover	Is Failover set up for this record? yes — Yes no — No

Request example

GET https://api.zilore.com/dns/v1/domains/example.com/geo
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0

Response example

{
"status": "ok",
"response": [{
"record_id": "13853",
"record_status": "enabled",
"record_name": "example.com",
"record_type": "A",
"record_value": "1.1.1.1",
"record_ttl": "3600",
"geo_region": "EU",
"geo_full_region": "Europe",
"default_records": [{
"record_id": "13852",
"record_value": "2.2.2.2",
"record_status": "1"
}],
"is_failover": "no"
}, {
"record_id": "65373",
"record_status": "enabled",
"record_name": "www.example.com",
"record_type": "A",
"record_value": "1.1.1.3",
"record_ttl": "60",
"geo_region": "_AF",
"geo_full_region": "Africa",
"default_records": [{
"record_id": "65370",
"record_value": "1.1.1.1",
"record_status": "1"
}, {
"record_id": "65371",
"record_value": "1.1.1.2",
"record_status": "1"
}],
"is_failover": "no"
}]
}