📣 Get more control and flexibility in managing your domain portfolio. Export your DNSimple domain names list in a .CSV file 👉 Read more

Manage all your domains using Ruby

We've got the best API to manage your domain portfolio while saving time and money.

A quick tour of our Ruby API in under 9 minutes.Pointing up arrow

Pointing straight arrow

A quick tour of our Ruby API in under 9 minutes.

Fast and easy to use.

Quickly check domain availability, add a DNS record, and request an SSL certificate directly from Ruby.

Never regretted signing up long ago.

Marius Maximus avatar Marius Maximus, DevOps

Configuring server-wide DNS template is made simple for our Enterprise Network with DNSimple.

Rithika G. avatar Rithika G., Cloud Engineer

A dependable service with amazing technical support.

Valters J. avatar Valters J., DevOps Engineer

Best DNS Hosting Company by far.

Dorian Kind avatar Dorian Kind, Director of Data & Technologies

Case studies

Learn how our customers use DNSimple to automate their companies' domain management — from registering domains and adding zone records, to reselling domains and managing cloud infrastructure.

A cute Ruby animation
Fun Fact

DNSimple was launched at RubyConf 2010.
The Ruby language has a very special place in our hearts.
We're happy to be part of this community.

Developer tips

Open a free account in our Sandbox environment. Write, test, and verify your code before you move to production.

Test domain registration and issuing SSL certificates at no charge. Domains registered in Sandbox do not resolve, and SSL certificates should not be installed in any production environment.

Use our testing credit card to select a plan that matches the features that you'd like to test.

Follow this guide to obtain your token for your API calls.

Create an account in Sandbox

Start by writing small scripts that explore how you can use the API. Writing a custom report is a good way to get exposure to different API endpoints and how you can combine those.

custom_report.rb
# Print my domains with expiration date and associated SSL certificate if any.

require "dnsimple"

dnsimple = Dnsimple::Client.new(
    base_url: "https://api.sandbox.dnsimple.com",
    access_token: TOKEN
)
domains = dnsimple.domains.list_domains(account_id).data
domains.each do |domain|
  print " - #{domain.name}:  #{domain.state} "
  if domain.state == 'registered'
    print "(expires on: #{domain.expires_at})"
  end
  puts
  certificates = client.certificates.certificates(account_id, domain.name).data

  unless certificates.empty?
    certificates.each do |certificate|
      print "       - #{certificate.common_name}: #{certificate.state} (years till expiry: #{certificate.years} "
      if certificate.auto_renew
        print "but will auto renew"
      end
      print ")"
      puts
    end
  end
end
          

Managing domains with similar configurations can be error prone. Use the Ruby API to automate DNS changes accross multiple domains with DNS templates.

In the script below, we've created a template to apply to any domain after registration.

apply_dns_template.rb
# Point a domain to hosting after registration

require "dnsimple"

dnsimple = Dnsimple::Client.new(
    base_url: "https://api.sandbox.dnsimple.com",
    access_token: TOKEN
)

# Creates a new template
template = dnsimple.templates.create_template(
    account_id,
    name: "Domain registration template",
    short_name: "after-domain-registration-template",
    description: "Point a domain to hosting after registration"
)

# Adds A record to template
dnsimple.templates.create_record(
    account_id,
    "after-domain-registration-template",
    name: "a",
    type: "A",
    content: "192.168.1.1",
    ttl: 600
)

# Register the domain. Omits contact logic for this example.
domain = dnsimple.registrar.register_domain(
    account_id,
    "domain-to-register.com",
    registrant_id: contact.id
)

# Apply the template to the registered domain
dnsimple.templates.apply_template(account_id, template, domain.data.name)
          

Reliable DNS at the right price

If you manage 100+ domains, get in touch.
We offer flexible plans with adjusted rates and discounts for Enterprise and Resellers.

Integrate in minutes with our API

Update DNS records, request SSL certificates, and transfer or register new domains from Ruby.

Manage your domains from Ruby.

Start your free 30-day trial

Photo by Christina @ wocintechchat.com on Unsplash