Skip to main content
GET
/
core
/
v1
/
domains
/
{domainName}
/
records
/
{id}
Get Record
curl --request GET \
  --url https://api.dev.name.com/core/v1/domains/{domainName}/records/{id} \
  --header 'Authorization: Basic <encoded-value>'
{
  "ttl": 123,
  "type": "<string>",
  "answer": "<string>",
  "domainName": "<string>",
  "fqdn": "<string>",
  "host": "<string>",
  "id": 123,
  "priority": 123
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Path Parameters

​
domainName
string
required

DomainName is the zone the record exists in.

​
id
integer<int32>
required

ID is the server-assigned unique identifier for this record.

Response

A successful response.

Record is an individual DNS resource record.

​
ttl
integer<int64>
required

TTL is the time this record can be cached for in seconds. name.com allows a minimum TTL of 300, or 5 minutes.

​
type
string | null
required

Type is one of the following: A, AAAA, ANAME, CNAME, MX, NS, SRV, or TXT.

​
answer
string

Answer is either the IP address for A or AAAA records; the target for ANAME, CNAME, MX, or NS records; the text for TXT records. For SRV records, answer has the following format: "{weight} {port} {target}" e.g. "1 5061 sip.example.org".

​
domainName
string

DomainName is the zone that the record belongs to.

​
fqdn
string
read-only

FQDN is the Fully Qualified Domain Name. It is the combination of the host and the domain name. It always ends in a ".". FQDN is ignored in CreateRecord, specify via the Host field instead.

​
host
string | null

Host is the hostname relative to the zone: e.g. for a record for blog.example.org, domain would be "example.org" and host would be "blog". An apex record would be specified by either an empty host "" or "@". A SRV record would be specified by "{service}.{protocol}.{host}": e.g. "_sip._tcp.phone" for _sip._tcp.phone.example.org.

​
id
integer<int32>
read-only

Unique record id. Value is ignored on Create, and must match the URI on Update.

​
priority
integer<int64>

Priority is only required for MX and SRV records, it is ignored for all others.