Get

View as Markdown

GET
/workspaces
/:workspace
/domains
/:domain_id
/records
/:record_name
/:type

Get one record by type

Request

REQUIRED SCOPES

ZONE_READ

URL PARAMETERS

workspacerequiredstring

The human-readable ID of the workspace

Example: "my-company"

domain_idrequiredstring

The ID of the domain

Example: "4krmDRPw"

record_namerequiredstring

The full record name with domain

Example: "api.example.com"

typerequiredstring enum

The record type

Allowed enum:

SOA,

NS,

A,

AAAA,

CNAME,

CAA,

SPF,

MX,

TXT,

SRV,

NAPTR

Example: "A"

Response

RESPONSE BODY

typestring enum

The record type

Allowed enum:

SOA,

NS,

A,

AAAA,

CNAME,

CAA,

SPF,

MX,

TXT,

SRV,

NAPTR

urlread-onlystring

API endpoint to GET this object

html_urlread-onlystring

Web URL to view this object in Buddy.works

namestring

The record name (subdomain or @ for root)

valuesstring[]

ttlinteger

Time To Live in seconds for the DNS record

routingstring

Routing strategy for the record (simple or geolocation)

countryobject

Country-specific routing configuration for geolocation records (only used when routing is 'geolocation')

continentobject

Continent-specific routing configuration for geolocation records (only used when routing is 'geolocation')

Last modified on Jan 26, 2026

List List by name

Request example

CURL
curl -X GET "https://api.buddy.works/workspaces/:workspace/domains/:domain_id/records/:record_name/:type" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json"

Response examples

A Record

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/example.com./A",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "name": "@",
  "type": "A",
  "values": [
    "192.168.1.100",
    "192.168.1.101"
  ],
  "ttl": 300,
  "routing": "simple"
}

STATUS
200 OK

CNAME Record

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/blog.example.com./CNAME",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "name": "blog",
  "type": "CNAME",
  "values": [
    "target.example.com."
  ],
  "ttl": 3600,
  "routing": "simple"
}

STATUS
200 OK

MX Record

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/example.com./MX",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "name": "@",
  "type": "MX",
  "values": [
    "10 mail1.example.com.",
    "20 mail2.example.com."
  ],
  "ttl": 3600,
  "routing": "simple"
}

STATUS
200 OK

TXT Record

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/example.com./TXT",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "name": "@",
  "type": "TXT",
  "values": [
    "v=spf1 include:_spf.example.com ~all",
    "google-site-verification=abc123def456ghi789jkl012"
  ],
  "ttl": 300,
  "routing": "simple",
  "country": null,
  "continent": null
}

STATUS
200 OK

Geolocation Record

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/api.example.com./A",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "name": "api",
  "type": "A",
  "values": [
    "192.168.1.100"
  ],
  "ttl": 300,
  "routing": "geolocation",
  "country": {
    "US": [
      "192.168.1.101",
      "192.168.1.102"
    ],
    "DE": [
      "192.168.1.103",
      "192.168.1.104"
    ],
    "JP": [
      "192.168.1.105"
    ]
  },
  "continent": {
    "Europe": [
      "192.168.1.110",
      "192.168.1.111"
    ],
    "NorthAmerica": [
      "192.168.1.112",
      "192.168.1.113"
    ],
    "Asia": [
      "192.168.1.114"
    ]
  }
}

STATUS
200 OK