Sign in
Domain > Order

Transfer Domain

Transfer a domain using prepaid payment (documentation: <a href='https://developer.infomaniak.com/docs/api/order/domain/how'>https://developer.infomaniak.com/docs/api/order/domain/how</a>)

post/2/domains/accounts/{account}/transfer

Path parameters

accountstring required

Request body

addressinteger

The debitor address id, if not specified will use the account's default address

amount_total_excl_taxnumber double required

Amount expected from the client, if calculated price is not equal, request will fail

domainstring required

The domain name ordered

nameserver_choice'"custom"' | '"infomaniak"' | '"keep"'

Specifies which nameservers to use after domain transfer. [keep] Preserves the current nameservers currently assigned to the domain (default), [infomaniak] Uses Infomaniak’s default nameservers, [custom] Allows you to set your own nameservers.

nameserversstring[]

Required if nameserver_choice parameter is custom. Array of nameservers to use for the domain

Example request

{
  "domain": "mydomain.ch",
  "nameserver_choice": "custom",
  "nameservers": [
    "ns1.mydomain.ch"
  ]
}

Response

OK

result'success' | 'error' | 'asynchronous' required

Result of the HTTP request

Example response

{
  "result": "success",
  "data": {
    "id": 12345,
    "name": "mydomain.ch",
    "tld": "ch",
    "resale_status": "not_authorized",
    "created_at": 1702908000,
    "expires_at": 1734444000,
    "contacts": {
      "owner": {
        "address_type": "loc",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Infomaniak",
        "street1": "Rue Eugène Marziano 25",
        "street2": "Batiment 43",
        "street3": "Etage 3",
        "postal_code": "1227",
        "city": "Les Acacias",
        "state": "Genève",
        "country_code": "CH",
        "id": 12345,
        "type": "Organization",
        "phone": "+41.223456789",
        "fax": "+41.223456790",
        "email": "contact@mydomain.ch",
        "validated_at": 1702908000,
        "created_at": 1702908000,
        "pending_modification": {
          "created_at": 1702908000,
          "associated_domains": [
            {
              "id": 1,
              "name": "mydomain.ch"
            }
          ],
          "associated_domains_count": 5000
        },
        "associated_domains": [
          {
            "id": 1,
            "name": "mydomain.ch"
          }
        ],
        "associated_domains_count": 5000
      },
      "admin": {
        "address_type": "loc",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Infomaniak",
        "street1": "Rue Eugène Marziano 25",
        "street2": "Batiment 43",
        "street3": "Etage 3",
        "postal_code": "1227",
        "city": "Les Acacias",
        "state": "Genève",
        "country_code": "CH",
        "id": 12345,
        "type": "Organization",
        "phone": "+41.223456789",
        "fax": "+41.223456790",
        "email": "contact@mydomain.ch",
        "validated_at": 1702908000,
        "created_at": 1702908000,
        "pending_modification": {
          "created_at": 1702908000,
          "associated_domains": [
            {
              "id": 1,
              "name": "mydomain.ch"
            }
          ],
          "associated_domains_count": 5000
        },
        "associated_domains": [
          {
            "id": 1,
            "name": "mydomain.ch"
          }
        ],
        "associated_domains_count": 5000
      },
      "tech": {
        "address_type": "loc",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Infomaniak",
        "street1": "Rue Eugène Marziano 25",
        "street2": "Batiment 43",
        "street3": "Etage 3",
        "postal_code": "1227",
        "city": "Les Acacias",
        "state": "Genève",
        "country_code": "CH",
        "id": 12345,
        "type": "Organization",
        "phone": "+41.223456789",
        "fax": "+41.223456790",
        "email": "contact@mydomain.ch",
        "validated_at": 1702908000,
        "created_at": 1702908000,
        "pending_modification": {
          "created_at": 1702908000,
          "associated_domains": [
            {
              "id": 1,
              "name": "mydomain.ch"
            }
          ],
          "associated_domains_count": 5000
        },
        "associated_domains": [
          {
            "id": 1,
            "name": "mydomain.ch"
          }
        ],
        "associated_domains_count": 5000
      },
      "billing": {
        "address_type": "loc",
        "first_name": "John",
        "last_name": "Doe",
        "company": "Infomaniak",
        "street1": "Rue Eugène Marziano 25",
        "street2": "Batiment 43",
        "street3": "Etage 3",
        "postal_code": "1227",
        "city": "Les Acacias",
        "state": "Genève",
        "country_code": "CH",
        "id": 12345,
        "type": "Organization",
        "phone": "+41.223456789",
        "fax": "+41.223456790",
        "email": "contact@mydomain.ch",
        "validated_at": 1702908000,
        "created_at": 1702908000,
        "pending_modification": {
          "created_at": 1702908000,
          "associated_domains": [
            {
              "id": 1,
              "name": "mydomain.ch"
            }
          ],
          "associated_domains_count": 5000
        },
        "associated_domains": [
          {
            "id": 1,
            "name": "mydomain.ch"
          }
        ],
        "associated_domains_count": 5000
      }
    }
  }
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.