Gandi Bar

Home > Domain names > New Domain Name and Email API

New Domain Name and Email API

A new API, but still in RPC XML

We have made the decision to make the same API available to you that we use for the website. This means that you will benefit from all our improvements at almost the same time as we do (like new extensions, new products, etc.).
This also means that you will have access to all of the extensions that Gandi provides, and that the price catalog can be queried directly via the API (thanks to new methods that allow you to query for the price at your price rate).
You can also create lists of operations, domain names, and contacts that you can apply filters to.
Finally, you may manage your Gandi Mail out-of-office reply via the Email API.

Documentation is already available at this address, and it contains examples in Python, Php, Nodejs, Perl, and Ruby.
You will find a step-by-step tutorial on how to use it, on this page or, if you prefer, you may download it as a PDF file.

The major differences

The idea from the beginning has been not to change everything, so your migrations will be smooth, using familiar terms and calls. Since we are mentioning migration, you should know that the current (old) API will not be updated, though it will be supported until June 30th, 2012 to give you time to start using the new version.
Concerning your migration, the two APIs are compatible and you can migrate between them method by method, giving you constant control over your transition to V2.
One point that may seem a bit trivial, but which will cause problems for some: there is no longer a method for logging in with a login and password in the new version. You must use an API key, which you can get here for your Gandi interface.
Finally, remember that this new API is open to everyone, whether or not you are a reseller. The only requirement is that you must have at least one domain name at Gandi and/or have a prepaid account that has enough funds for your operations.

What is an API used for?

Our API lets you do the same thing with domain names from your website as we do on ours. For example, you can use the scripts to program renewal reminders at the dates that you choose, provide your family, friends, or customers (if you are a reseller) with your own interface that will allow them to create email or web forwarding addresses, program out-of-office replies for their email, etc.

When will it be available?

The OT&E (Operational Test and Evaluation) test platform is already available at the address
The production platform will be available in 3 to 4 weeks.

Changes to come

What we will soon be integrating into the new domain name API (and not into the V1 API) will please many of you. The finishing touches are being added to DNS zone file management. Additionally, we expect DNSSEC to follow a couple weeks after that. Owner changes are in the works, however we still have one more migration to do in our system before it will be compatible with the API methods.

Update: as of Feb 28, 2012, the new API is active. Documentation is available at

As a reminder, if you have not yet activated your API on your account, you will need to activate it and use the API in OT