GoDaddy
Support
API ReferenceDomain LifecycleDomains & DNSv3 (Recommended)

Records

View as Markdown

CRUD operations on DNS records within the GoDaddy-managed zone. Sub-collection of /zones/{zone}. Changes are applied synchronously.

List DNS records in a zone

GET
/zones/{zone}/dns-records

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Path Parameters

zone*string

The domain name in punycode A-label form (for example, example.com). For IDNs, use the punycode representation.

Query Parameters

page?integer

One-based page number for offset-based pagination. Defaults to 1.

Default1
Range1 <= value
pageSize?integer

Maximum number of items to return per page.

Default25
Range1 <= value <= 100
totalRequired?boolean

When true, the response includes totalItems and totalPages for the current filter when at least one record matches. Both are omitted when the result set is empty. Defaults to false; omitting totals avoids the cost of a count query on large collections.

Defaultfalse
fields?string

Comma-separated list of fields to include in each item of the response. Omitted fields are excluded from the payload. When absent, all fields are returned. Field names must match properties defined on the item schema for the operation; any unknown or invalid name returns 400 Bad Request.

type?DNS Record Type

Filter results to records of this DNS type.

Value in"A" | "AAAA" | "CNAME" | "MX" | "TXT" | "NS" | "SRV" | "SOA" | "CAA" | "ALIAS"
name?string

Filter results to records with this host name relative to the zone. Use @ for the zone apex.

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.godaddy.com/v3/domains/zones/example.com/dns-records?page=2&pageSize=25&totalRequired=true&fields=name%2Ctype%2Cdata%2Cttl&type=A&name=app2"
{
  "items": [
    {
      "recordId": "Aad7oqdXCms9mlJvm_m6UFYqmwjyP20H2KBmQHgttK9kGbF_TuI3knsocArQqIv5I0Kq5C0",
      "name": "@",
      "type": "A",
      "data": "192.0.2.1",
      "ttl": 3600
    },
    {
      "recordId": "ARZaSm3N9qvJemM6yBmuXIO6F_YIfqSiZcaHhHFozlDsDhdOr1njlXc09TAPJlm8dXqGttRrjRKIgiXpXVm9fms",
      "name": "app2",
      "type": "A",
      "data": "192.0.2.2",
      "ttl": 3600
    }
  ],
  "totalItems": 150,
  "totalPages": 6,
  "links": [
    {
      "rel": "self",
      "href": "/v3/domains/zones/example.com/dns-records?type=A&name=app2&page=2&pageSize=25&totalRequired=true"
    },
    {
      "rel": "first",
      "href": "/v3/domains/zones/example.com/dns-records?type=A&name=app2&page=1&pageSize=25&totalRequired=true"
    },
    {
      "rel": "last",
      "href": "/v3/domains/zones/example.com/dns-records?type=A&name=app2&page=6&pageSize=25&totalRequired=true"
    },
    {
      "rel": "next",
      "href": "/v3/domains/zones/example.com/dns-records?type=A&name=app2&page=3&pageSize=25&totalRequired=true"
    },
    {
      "rel": "prev",
      "href": "/v3/domains/zones/example.com/dns-records?type=A&name=app2&page=1&pageSize=25&totalRequired=true"
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}

Create a DNS record for a zone

POST
/zones/{zone}/dns-records

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Path Parameters

zone*string

The domain name in punycode A-label form (for example, example.com). For IDNs, use the punycode representation.

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Request Body

application/json

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.godaddy.com/v3/domains/zones/example.com/dns-records" \  -H "Content-Type: application/json" \  -d '{    "name": "@",    "type": "A",    "data": "192.0.2.1",    "ttl": 3600  }'
{
  "recordId": "rec_a1b2c3d4",
  "name": "www",
  "type": "A",
  "data": "93.184.216.34",
  "ttl": 3600,
  "priority": 0,
  "service": "string",
  "port": 0,
  "weight": 0,
  "protocol": "string",
  "flag": 0,
  "tag": "string"
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}

Delete a DNS record

DELETE
/zones/{zone}/dns-records/{recordId}

Authorization

bearerAuth
AuthorizationBearer <token>

Personal Access Token (PAT). Generate one from the developer dashboard. Pass as: Authorization: Bearer <token>.

In: header

Path Parameters

zone*string

The domain name in punycode A-label form (for example, example.com). For IDNs, use the punycode representation.

recordId*string

Server-assigned DNS record identifier within the zone.

Header Parameters

X-Request-Id?string

Optional client-generated request correlation identifier, propagated across services and returned in the response X-Request-Id header.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://api.godaddy.com/v3/domains/zones/example.com/dns-records/Aad7oqdXCms9mlJvm_m6UFYqmwjyP20H2KBmQHgttK9kGbF_TuI3knsocArQqIv5I0Kq5C0"
Empty
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}
{
  "name": "string",
  "correlationId": "string",
  "message": "string",
  "informationLink": "string",
  "details": [
    {
      "field": "string",
      "value": "string",
      "location": "body",
      "issue": "string",
      "description": "string"
    }
  ],
  "links": [
    {
      "href": "http://example.com",
      "rel": "string",
      "title": "string",
      "targetMediaType": "string",
      "targetSchema": null,
      "method": "string",
      "submissionMediaType": "application/json",
      "submissionSchema": null
    }
  ]
}

Agent & Automation Notes

Scopesdomains.domain:read, domains.domain:create, domains.dns:update, domains.nameserver:update
Rate limit60 req/min per credential
On failureGET operations are safe to retry. POST registrations use Idempotency-Key. Poll async operations — do not resubmit.

Related

Last updated on

How is this guide?

Domain Management PUT

Non-commercial async mutations on owned domain instances: contacts, nameservers, privacy, auto-renew, and transfer-lock. All sub-resources of /domain-names/{domain-name}. All mutations return a DomainOperation for polling.

Operations GET

Abstract operation polling. Poll GET /operations/{operationId} for any domain mutation until it reaches COMPLETED or FAILED. Operation IDs are unique across Registration, Renewal, and Transfer — clients that prefer typed polling can use the concrete resource endpoints instead.