General Documentation for Gandi's Public API


Welcome to Gandi's v5 API!

Gandi provides remote RESTful APIs over HTTPS, making it easy to manage your products and build third-party applications.

This document is a complete reference guide to using Gandi's v5 API.

If you encounter any errors and need assistance, please use our online form to contact our customer support team.

RESTful interface


All connections to must be issued over HTTPS.


Gandi's API does not maintain sessions. In other words, a request does not depend on previous requests, only its arguments. It only provides object descriptions.

Rate limit

Gandi's API is rate limited; you can perform a maximum of 1000 requests per minute from the same IP address.

Content-Type header

POST, PUT and PATCH requests you perform must contain the following HTTP header:

Content-Type: application/json

Sharing ID

You can pass one of your organization IDs with the sharing_id query string parameter for some requests. This parameter, unless stated otherwise, serves two purposes:

  • for GET requests on collections, it acts like a filter on returned data.
  • for POST, PATCH, or PUT requests that trigger a payment, it indicates the organization that will pay for the ordered product.

You can retrieve your organization list using the Organization API

Sandbox API

New! A Sandbox API is now available on Please read our guide to learn more and activate a sandbox account.