API Documents
Contents
    Loading
Documentation API Documents Get Record List

Get Record List

1. API Description

This API (Record.List) is used to get record list.
Domain name for API request:https://api.dnspod.com/Record.List
HTTP request method: POST

2. Request Parameters

The table below lists only the API request parameters. Common request parameters are required when the API is called. For more information, please see Common Request Parameters.

Parameter Required Description
domain_id yes The domain id. Mandatory parameter.
offset no The offset of the response.The first one is numbered as 0.Optional parameter.
length no The number of response result.Optional parameter.
sub_domain no If the subsidiary domain is set,only the information about it will be responded.

3. Response Codes

Only the response codes related to this API are listed below. For other response codes, please see Common Return Codes.

Response Code Description
-7 A domain of a company account need a upgrade first.
-8 You need a upgrade for the domain you are acting for.
6 Invalid domain id.
7 Invalid offset.
8 Invalid length.
9 You don’t have the permission.
10 Empty result.

Attention:
If there are more than 500 records,only the first 500 will be responded.You may need to set “offset” and “length” to get all the records with requests.

4. Sample

curl -X POST https://api.dnspod.com/Record.List -d 'user_token=730060,e1a8a$f14dc5dcbafd83680b3d2a553c4d553d&format=json&domain_id=2317346'

The following is a sample response:

  • JSON:
{
     "status": {
         "code": "1",
         "message": "Action completed successful",
         "created_at": "2014-06-05 09:58:40"
     },
     "domain": {
         "id": "9",
         "name": "dnspod.com",
         "punycode": "dnspod.com",
         "grade": "DP_Free",
         "owner": "yizerowu@dnspod.com"
     },
     "info": {
         "sub_domains": "5",
         "record_total": "5"
     },
     "records": [
         {
             "id": "50",
             "name": "@",
             "line": "Default",
             "type": "A",
             "ttl": "600",
             "value": "96.126.115.73",
             "mx": "0",
             "enabled": "1",
             "status": "enabled",
             "monitor_status": "",
             "remark": "",
             "updated_on": "2014-06-05 09:47:59"
         },
         {
             "id": "49",
             "name": "@",
             "line": "Default",
             "type": "MX",
             "ttl": "600",
             "value": "cloudmx.qq.com.",
             "mx": "5",
             "enabled": "1",
             "status": "enabled",
             "monitor_status": "",
             "remark": "",
             "updated_on": "2014-06-05 09:47:59"
         },
         {
             "id": "46",
             "name": "@",
             "line": "Default",
             "type": "NS",
             "ttl": "600",
             "value": "a.dnspod.com.",
             "mx": "0",
             "enabled": "1",
             "status": "enabled",
             "monitor_status": "",
             "remark": "",
             "updated_on": "2014-06-05 09:47:40",
             "hold": "hold"
         },
         {
             "id": "47",
             "name": "@",
             "line": "Default",
             "type": "NS",
             "ttl": "600",
             "value": "b.dnspod.com.",
             "mx": "0",
             "enabled": "1",
             "status": "enabled",
             "monitor_status": "",
             "remark": "",
             "updated_on": "2014-06-05 09:47:40",
             "hold": "hold"
         },
         {
             "id": "48",
             "name": "@",
             "line": "Default",
             "type": "NS",
             "ttl": "600",
             "value": "c.dnspod.com.",
             "mx": "0",
             "enabled": "1",
             "status": "enabled",
             "monitor_status": "",
             "remark": "",
             "updated_on": "2014-06-05 09:47:40",
             "hold": "hold"
         }
     ]
 }
Last updated on 2020-12-23 08:40

DNSPod Technical Community

Sharing & discussions

Scan using WeChat

Official WeChat group

Join WeChat group to chat and feedback

Scan using WeChat