Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

DNSimple API Documentation

This is the DNSimple API documentation.


This website is built with nanoc. If you want to learn how to run the site locally, or how to contribute, please visit the CONTRIBUTING file.


These are the most important folders and files to keep in mind while working on this repo:

  • content: this folder contains the markdown files that generate the site
  • content/v2/openapi.yml: the API definition described using the OpenAPI specification (see below)
  • examples: this folder contains the API response fixtures generated from real API calls you can use to test your integrations

OpenAPI definition

The API behavior is described using the OpenAPI specification. The definition file is located at content/v2/openapi.yml.

The OpenAPI description is the main source of truth, and must be kept up to date with the other changes in the site. At the time being, the site and the OpenAPI must be kept in sync manually. That means any change in the markdown documentation files needs to be reflected in the OpenAPI file.

The markdown documentation is a subset of the OpenAPI description. There may be information that - for the sake of brevity - are omitted in the markdown files, and sometimes delegated to the OpenAPI description.