Get a List of Domains
The Get a List of Domains method returns a List of Domains.
The List of Domains can be shown page by page. To split by page, the following Arguments should be passed:
- the page number (page);
- the amount of items per page (per_page).
The List of Domains can be sorted by any field. To sort the List of Domains, the following Arguments should be passed:
- the field name that is used for sorting (sorting[field]);
- the sort direction (sorting[reversed]):
- true - the list will be sorted in descending direction;
- false - the list will be sorted in ascending direction (by default).
The List of Domains can be filtered by:
- creation date (filters[created_at]);
- update date (filters[updated_at]);
- account id (filters[account_id]);
- domain name (filters[name]).
GET /api/vendor/v1/domains.json?api_token={api_token}
Arguments
Name | Parameter Type | Data type | Required/Optional | Description |
---|---|---|---|---|
api_token | query | string | Required | API token of the manager who perform the operation (see API Token Authentication). |
page | query | integer | Optional | Returning a list of domains by current page number. |
per_page | query | integer | Optional | Setting a number of items in the page. |
sorting[field] | query | string | Optional | Sorting the list by a specified field. |
sorting[reversed] | query | string | Required | Setting the sorting mode:
|
filters[created_at] | query | date | Optional | Filtering the list by a creation date. |
filters[updated_at] | query | date | Optional | Filtering the list by an update date. |
filters[account_id] | query | string | Optional | Filtering the list by an account ID. |
filters[name] | query | string | Optional | Filtering the list by a domain name account ID. |
Response model
Name | Data type | Description |
---|---|---|
id | integer | A domain ID. |
account_id | integer | An account ID, to whom relates the domain. |
name | string | A domain name. |
records | array | A list of DNS records of the domain. |
Request example
GET http://billing.activeplatform.com:80/api/vendor/v1/domains.json?api_token=654321
Response example
[
{
"id": 8,
"account_id": 2000036,
"name": "lynctest11.com",
"records": [
{
"name": "lynctest11.com.",
"type": "SOA",
"content": {
"primary": "ns1.systemdns.com",
"hostmaster": "john.doe@gmail.com",
"serial": "2014123002",
"refresh": "7200",
"retry": "2419200",
"expire": "3600",
"default_ttl": "3600"
},
"ttl": 3600,
"prio": null,
"raw_content": "123.123.123.123"
}
]
}
]