List by name

View as Markdown
  • GET
  • /workspaces
  • /:workspace
  • /domains
  • /:domain_id
  • /records
  • /:record_name

Get all records for domain or subdomain

Request

REQUIRED SCOPES
DOMAIN_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"

Response

RESPONSE BODY
urlread-onlystring
API endpoint to GET this object
html_urlread-onlystring
Web URL to view this object in Buddy.works
recordsRecordViewIds[]

Last modified on Apr 22, 2026

Request example

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

Response examples

Records List
EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "records": [
    {
      "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/example.com./SOA",
      "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
      "type": "SOA",
      "name": "@"
    },
    {
      "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/example.com./NS",
      "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
      "type": "NS",
      "name": "@"
    },
    {
      "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records/www.example.com./A",
      "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
      "type": "A",
      "name": "www"
    },
    {
      "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",
      "type": "A",
      "name": "api"
    },
    {
      "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",
      "type": "CNAME",
      "name": "blog"
    }
  ]
}
STATUS
200 OK
Partial Records List
EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "records": [
    {
      "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",
      "type": "A",
      "name": "api"
    }
  ]
}
STATUS
200 OK
No Records List
EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/my-company/domains/4krmDRPw/records",
  "html_url": "https://app.buddy.works/my-company/-/domain/4krmDRPw",
  "records": []
}
STATUS
200 OK